Tham chiếu CLI

Toàn bộ lệnh sqctl của ứng dụng dòng lệnh SecurQbit — đăng nhập, kết nối, chọn quốc gia, đổi tùy chọn, cập nhật và kết xuất cho máy đọc.

sqctl là cách bạn điều khiển SecurQbit từ cửa sổ dòng lệnh. Nó nói chuyện với dịch vụ chạy nền qua một socket cục bộ; nó không giữ thông tin đăng nhập và không cần quyền riêng nào. Nếu bạn chưa cài, hãy bắt đầu ở Cài đặt trên máy tính & router.

Mọi lệnh đều nhận --json, in ra tài liệu thô thay vì phần hiển thị đã trình bày. Đó mới là giao diện để viết script — cách trình bày cho người đọc có thể thay đổi.

Tổng quan

sqctl status                        VPN có bật không, và bằng tài khoản nào
sqctl login                         đăng nhập bằng cách duyệt một liên kết trong trình duyệt
sqctl logout
sqctl locations                     các quốc gia gói cước này dùng được
sqctl connect [COUNTRY] [--fastest]
sqctl disconnect
sqctl set                           xem tùy chọn
sqctl set country DE|any
sqctl set autoconnect on|off
sqctl set updates on|off
sqctl update [--check] [--yes]      cài bản mới nhất

sqctl status

Cho biết bạn có đang được bảo vệ không, và bằng tài khoản nào.

$ sqctl status
 
  ● Connected      Germany
    Connected for  12m 40s
    Transferred    ↓ 148 MB   ↑ 22 MB
 
    Account        Alice  [email protected]
    Plan           Monthly
    Renews         1 September 2026

Nó cố ý không hiển thị bất cứ điều gì về cách đường hầm được dựng — không địa chỉ máy chủ, không mã phiên. Bạn chẳng làm gì được với chúng, và riêng địa chỉ máy chủ thì không nên lọt vào một ảnh chụp màn hình khi bạn nhờ hỗ trợ.

Nếu dịch vụ không chạy, sqctl sẽ nói vậy và in ra đúng lệnh khởi động nó trên máy này, bất kể hệ thống khởi động là loại nào.

Đăng nhập máy tính này bằng cách duyệt nó trong trình duyệt.

$ sqctl login
 
Open this link to approve the sign-in:
 
    https://accounts.securqbit.com/device?code=BCDF-GHJK
 
Check the page shows this code:
 
    B C D F - G H J K
 
Waiting for approval — expires in 10 minutes, Ctrl-C to cancel

Mở liên kết — sqctl sẽ thử mở giúp bạn, và --no-browser ngăn nó làm vậy — đăng nhập nếu bạn chưa đăng nhập, kiểm tra mã trên trang khớp với mã trong cửa sổ dòng lệnh, rồi duyệt. Không bao giờ phải gõ gì trở lại cửa sổ dòng lệnh.

Chính phép đối chiếu đó là toàn bộ tính bảo mật của cách làm này.

Chỉ duyệt yêu cầu do chính bạn khởi tạo. Nếu ai đó gửi cho bạn một liên kết như vậy và bạn duyệt nó, bạn vừa đưa máy của họ vào tài khoản của bạn. Mã và tên máy hiển thị trên trang tồn tại chính là để bạn nhận ra khác biệt.

Đăng nhập đòi hỏi một tài khoản đã có sẵn. Hãy tạo trong ứng dụng iOS hoặc Android — kể cả tài khoản khách, vốn vào accounts.securqbit.com bằng mã khôi phục và duyệt từ đó như mọi tài khoản khác.

sqctl logout

Tắt VPN và đăng xuất máy tính này. Đường hầm được hạ trước, một cách có chủ ý: để nó tiếp tục chạy trên thông tin đăng nhập vừa bị thu hồi sẽ bỏ lưu lượng của bạn lại trong một phiên mà máy chủ sắp xóa.

Tài khoản khách sẽ được hỏi xác nhận trước, vì không có mã khôi phục thì bạn không đăng nhập lại được. --force bỏ qua câu hỏi.

sqctl connect

sqctl connect            # tùy chọn đã lưu của bạn
sqctl connect DE         # hiện diện ở Đức
sqctl connect --fastest  # để SecurQbit chọn

Quốc gia là mã hai chữ cái — chạy sqctl locations để xem gói của bạn cho phép những đâu. Kết nối mất vài giây; cửa sổ dòng lệnh bám theo trạng thái thật khi nó thay đổi thay vì im lặng.

Bản dùng thử không chọn được quốc gia. Với gói dùng thử, hãy dùng --fastest. Chỉ định một quốc gia sẽ trả về lỗi cho biết cần gói trả phí, thay vì lặng lẽ nối bạn tới nơi khác. Xem Tài khoản & thanh toán.

sqctl disconnect

Hạ đường hầm và trả định tuyến cùng DNS của bạn về như cũ.

Ngắt kết nối cũng chính là điều bảo SecurQbit dừng lại. Nếu đường hầm tự đứt, dịch vụ sẽ tiếp tục cố dựng lại — đó là điều bạn muốn ở một chiếc laptop vừa thức khỏi chế độ ngủ hay một router có đường truyền chập chờn. Chỉ sqctl disconnect, đăng xuất, hoặc tắt dịch vụ mới hủy ý định đó.

sqctl locations

Liệt kê theo tên các quốc gia gói của bạn dùng được.

$ sqctl locations
 
    DE             Germany
    FR             France
    NL             Netherlands
    SG             Singapore
    US             United States

sqctl set

Xem hoặc đổi tùy chọn của bạn. Có ba, và đó đúng là ba thứ thuộc quyền chọn của bạn.

sqctl set                    # xem cả ba
sqctl set country DE         # mặc định là Đức
sqctl set country any        # mặc định là nhanh nhất
sqctl set autoconnect on     # kết nối ngay khi máy khởi động
sqctl set updates off        # ngừng tìm phiên bản mới

$ sqctl set
 
    Location       Germany (DE)
    Auto-connect   on
    Updates        on

Mọi thứ còn lại của đường hầm — dựng thế nào, dùng DNS gì, thử lại ra sao — đã được quyết định thay bạn và không truy cập được từ dòng lệnh. Đó không phải những lựa chọn mà cứ đưa ra là VPN tốt lên.

updates là một thiết lập chứ không phải hằng số, vì việc kiểm tra là một cuộc gọi định kỳ tới CDN của SecurQbit, và người vận hành một VPN hoàn toàn có quyền từ chối điều đó.

sqctl update

Cài phiên bản mới nhất.

sqctl update            # hỏi, rồi cài và khởi động lại
sqctl update --check    # chỉ cho biết có bản mới hay không
sqctl update --yes      # không hỏi

$ sqctl update
 
  ! Update available
 
    Installed      v1.0.0
    Latest         v1.1.0
 
  SecurQbit restarts to finish, so the VPN disconnects for a moment.
 
Install it now? [y/N]

Tệp tải về được đối chiếu với các mã kiểm tra đã công bố trước khi bất cứ thứ gì bị thay, rồi dịch vụ khởi động lại trên phiên bản mới. sqctl chờ nó quay lại và đọc phiên bản từ chính nó, nên điều bạn được báo là thứ đang thật sự chạy, chứ không phải thứ vừa được ghi xuống đĩa.

SecurQbit cũng tự kiểm tra mỗi ngày một lần, và chỉ dừng ở việc báo cho bạn — một dòng dưới sqctl status:

    Update         v1.1.0 available — run: sqctl update

Nó không bao giờ tự cài. Hoàn tất một bản cập nhật nghĩa là khởi động lại, mà khởi động lại thì ngắt đường hầm đang dùng; làm thế với ai đó mà không báo trước còn tệ hơn để họ chậm một phiên bản.

Nếu SecurQbit được cài bằng trình quản lý gói của bản phân phối, sqctl update sẽ từ chối trước khi tải bất cứ thứ gì và bảo bạn cập nhật đúng theo cách đã cài.

Viết script

--json trên bất kỳ lệnh nào sẽ in ra tài liệu giao thức:

$ sqctl status --json | jq '.state, .country'
"connected"
"DE"

# Kết nối rồi kiểm tra xem có thật sự thành công không
sqctl connect --fastest --json > /dev/null
test "$(sqctl status --json | jq -r .state)" = connected

Mã thoát: 0 thành công, 1 lệnh thất bại, 2 không liên lạc được với dịch vụ SecurQbit.

Khi có gì đó trục trặc

sqctl dịch các lỗi thành thứ bạn có thể hành động được, và giữ phần bên trong ra khỏi tầm mắt. Khi bạn cần đúng phần bên trong đó — để báo lỗi — có một lệnh chẩn đoán ẩn:

sqctl debug          # phiên bản, mọi thứ nằm ở đâu, socket nào đã trả lời,
                     # engine của đường hầm, và lỗi cuối cùng ở dạng thô
sqctl debug probe DE # kiểm tra một máy chủ từ đầu đến cuối mà KHÔNG kết nối

sqctl debug probe mới là lệnh hữu dụng. Nó khởi động proxy tới một máy chủ thật, gửi một yêu cầu qua đó và báo lại địa chỉ mà đầu kia nhìn thấy — nhưng nó không tạo thiết bị đường hầm nào và không đổi định tuyến nào, nên nó cho bạn biết đường đi có hoạt động không mà không lấy mất kết nối internet của bạn nếu nó không hoạt động.

Hãy kèm kết xuất của sqctl debug khi báo cáo sự cố. Xem Khắc phục sự cố.

Bước tiếp theo

Cài đặt trên máy tính & router — cài, cập nhật và gỡ bỏ.
Kết nối tới máy chủ — cách chọn máy chủ hoạt động.
Vượt tường lửa & che giấu lưu lượng — trên mạng bị hạn chế.