Vận hành máy chủ

Quản trị và cấu hình

Trang quản trị, gửi mã đăng ký (SMS, email), các giá trị cấu hình máy chủ, sao lưu và bảo mật — tài liệu tham chiếu cho người vận hành.

Máy chủ có sẵn một trang quản trị mở bằng trình duyệt. Tại đây bạn xem trạng thái máy chủ, quyết định cách gửi mã đăng ký và đăng nhập, và quản lý người dùng cũng như bot. Tài liệu này là tài liệu tham chiếu, tập hợp trang quản trị và các giá trị cấu hình máy chủ vào một chỗ. Nếu bạn cần cài đặt trước, hãy xem Cài đặt máy chủ.

Giao diện trang quản trị hiện bằng tiếng Hàn. Khi tài liệu này nhắc đến một tab, nút hay mục cài đặt, nhãn tiếng Hàn đúng như trên màn hình được ghi kèm trong ngoặc.

Mở trang quản trị

Trang quản trị nằm ở /admin/ trên cổng HTTP quản trị (8080 trong cấu hình vận hành), và chỉ mở trên chính máy chủ (127.0.0.1). Người vận hành truy cập qua tunnel SSH.

# Trên máy tính của bạn (để nguyên cửa sổ này)
ssh -N -L 8080:127.0.0.1:8080 <người-dùng>@<máy-chủ>
# Trình duyệt: http://localhost:8080/admin/

# Token (trên máy chủ)
sudo cat /srv/pabal/pabal_server/data/admin-token

Nhập token rồi bấm Mở (열기). Trình duyệt sẽ ghi nhớ token; muốn xóa thì bấm Xóa token (토큰 지우기) ở góc trên bên phải. Muốn tự đặt token, hãy truyền TELEGRAM_ADMIN_TOKEN (từ 16 ký tự trở lên) — khi đó máy chủ sẽ không ghi tệp token.

Các tab hiển thị gì

Các thao tác nguy hiểm (đăng xuất, chặn, hủy mã) phải bấm hai lần mới được thực hiện.

Mã đăng ký và đăng nhập

Khi người dùng nhập số điện thoại vào ứng dụng, máy chủ tạo mã và gửi theo cách đã chọn trong tab Cài đặt (설정).

• Với cách email, đăng ký mới có thể dùng địa chỉ bất kỳ, và địa chỉ đó trở thành email đăng nhập của tài khoản. Tài khoản đã có chỉ nhận mã qua email đăng nhập đã đăng ký — để ngăn việc ai đó điền địa chỉ của mình vào số điện thoại của người khác để vào tài khoản. Tài khoản đã có mà chưa có email đăng nhập sẽ được gửi mã qua SMS (nếu đã cấu hình) hoặc qua trang quản trị. Bạn có thể nhập email đăng nhập cho người dùng trong tab Người dùng (사용자).
• Việc gửi diễn ra ở phía sau, nên ứng dụng chuyển ngay sang màn hình nhập mã. Kết quả gửi (thành công, thất bại và lý do) hiện trong tab Mã đăng ký.
• Chỉ đăng ký (nhập tên) được sau khi đã nhập đúng mã. Mã sai chỉ được chấp nhận trong số lần cho phép; sau đó ngay cả mã đúng cũng bị từ chối.

Cài đặt — đăng ký và đăng nhập

Cài đặt — SMS

Nội dung tin nhắn có thể chứa {code} (mã) và {minutes} (thời hạn hiệu lực). Mặc định: [파발] 인증 코드: {code} (nghĩa là "[Pabal] Mã xác thực: {code}"; mặc định này bằng tiếng Hàn, bạn có thể đổi nội dung). Sau khi lưu, hãy kiểm tra bằng Gửi thử (테스트 발송).

Cài đặt — email (SMTP)

Địa chỉ gửi phải là địa chỉ mà tài khoản SMTP được phép gửi. Tiêu đề và nội dung cũng dùng được {code}, {minutes}.

Quản lý người dùng

• Đăng xuất mọi thiết bị (모든 기기 로그아웃): ngắt mọi phiên đăng nhập (khóa xác thực) của tài khoản đó. Dùng cho người dùng bị mất thiết bị.
• Chặn số (번호 차단): số đó không nhận được mã, và tài khoản của số đó bị đăng xuất ngay khỏi mọi thiết bị. Giống với danh sách chặn số điện thoại (전화번호 차단) trong tab Cài đặt.
• Email đăng nhập (로그인 이메일): cần thiết để tài khoản đã có đăng nhập bằng email khi dùng cách email.
• @BotFather là bot bên trong máy chủ nên không thể bị đăng xuất.

Quản lý bot

Trong tab Bot (봇), bạn xem cách kết nối của từng bot — có đang kết nối qua MTProto không, có gọi getUpdates qua HTTP trong 1 phút gần đây không, địa chỉ webhook là gì và hiện có đang thất bại không (kèm lý do). Nếu số update đang chờ cứ tăng mãi, nghĩa là chương trình bot đã dừng hoặc webhook đang thất bại. Việc xóa bot và cấp lại token do người tạo bot thực hiện tại @BotFather.

Biến môi trường

Máy chủ đọc tệp cấu hình (server-config.json) rồi ghi đè bằng biến môi trường. Tệp compose vận hành đã đặt sẵn các giá trị dưới đây, nên thông thường bạn chỉ cần sửa .env.

Tệp dữ liệu

Ghi chú bảo mật

• Đừng mở cổng quản trị trực tiếp ra Internet. Caddy trong cấu hình vận hành chặn các đường dẫn quản trị như /admin, /health, /metrics bằng 404.
• Mọi request dữ liệu quản trị đều cần Authorization: Bearer <token>, và trang của website khác không thể đọc được dữ liệu này.
• Các giá trị bí mật SMS và SMTP chỉ nằm trong operations.json; màn hình và API chỉ báo "đã lưu". Nếu để trống ô giá trị bí mật khi lưu, giá trị cũ vẫn được giữ.
• Token và giá trị bí mật không bị ghi vào log, còn số điện thoại trong log được che bớt. Địa chỉ Bot API (có chứa token) cũng không được ghi vào log.
• Khóa xác thực nằm trong DB, nên người truy cập được DB có thể giải mã lưu lượng của người dùng. Hãy bảo vệ DB và bản sao lưu kỹ như khóa RSA.

Giới hạn

• Mã đang chờ và lịch sử gần đây nằm trong bộ nhớ nên sẽ mất khi máy chủ khởi động lại (chỉ cần yêu cầu lại trong ứng dụng).
• Việc gửi thật của nhà cung cấp SMS cần được kiểm tra bằng tài khoản của từng nhà cung cấp. Máy chủ tạo request theo đúng tài liệu của từng nhà cung cấp.
• Chưa có: xóa tài khoản, buộc xóa bot, xem tin nhắn, xem log, biểu đồ.