Chuyển đến nội dung chính

Tạo người dùng quản trị viên

Với các bản triển khai Overleaf Toolkit:
Overleaf Toolkit
Với các bản triển khai docker-compose.yml cũ:
Legacy docker-compose
Lệnh này sẽ tạo một người dùng với địa chỉ email được cung cấp nếu người dùng đó chưa tồn tại, và đặt họ làm quản trị viên. Kết quả của lệnh bao gồm một URL mà bạn có thể truy cập để đặt mật khẩu cho người dùng này và đăng nhập lần đầu.
Nếu muốn thực hiện theo cách lập trình, bạn có thể dùng cùng script này để tạo người dùng thông thường cũng như quản trị viên. Đối với người dùng thông thường, hãy bỏ cờ —admin.
Nếu bạn sử dụng tài khoản nội bộ để xác thực và cần nâng quyền một người dùng hiện có thành quản trị viên phiên bản hoặc thu hồi quyền quản trị, hãy làm như sau:
1

Qua giao diện quản trị

  • Đăng nhập bằng một tài khoản quản trị viên hiện có.
  • Nhấp Admin -> Manage Users.
  • Tìm người dùng và nhấp vào tên của họ.
  • Nhấp biểu tượng bút chì.
  • Bật hoặc tắt Admin.
  • Nhấp Save để hoàn tất.

Xóa người dùng

Nói chung không nên xóa tài khoản trừ khi chúng không còn cần thiết. Xóa tài khoản sẽ gỡ bỏ tài khoản và khiến cộng tác viên mất quyền truy cập vào dự án. Để ngăn người dùng đăng nhập mà vẫn giữ dữ liệu của họ, hãy vô hiệu hóa tài khoản thay vì xóa. Theo mặc định, tài khoản được xóa mềm (soft-delete). Để biết thông tin về việc xóa vĩnh viễn người dùng khỏi phiên bản của bạn, hãy xem ENABLE_CRON_RESOURCE_DELETION trong hướng dẫn Biến môi trường.
Tài khoản được xóa mềm theo mặc định. Xem ENABLE_CRON_RESOURCE_DELETION để biết cách hoạt động của việc xóa vĩnh viễn.

Qua Admin -> Manage Users

1
  • Đăng nhập với tư cách quản trị viên.
  • Nhấp Admin -> Manage Users.
  • Tìm người dùng và đánh dấu ô bên cạnh tên của họ.
  • Nhấp vào biểu tượng thùng rác.
  • Nhấp Delete account để xác nhận.

Qua dòng lệnh

Có thể xóa tài khoản người dùng (và các dự án của họ) bằng các lệnh sau. Với các bản triển khai Overleaf Toolkit:
Overleaf Toolkit
Với các bản triển khai docker-compose.yml cũ:
Legacy docker-compose
Script xóa sử dụng một tùy chọn force được cố định sẵn, đảm bảo việc xóa vẫn được tiến hành ngay cả khi email thông báo xóa tài khoản không gửi được (ví dụ: khi email của người dùng không còn hoạt động).
Có thể dùng tùy chọn —skip-email để không gửi email thông báo đến người dùng bị xóa.

Khôi phục người dùng đã bị xóa mềm

Nếu người dùng chỉ bị xóa mềm, bạn có thể khôi phục tài khoản và các dự án bị xóa cùng tài khoản. Các dự án người dùng tự xóa vẫn bị xóa.
1
  • Đăng nhập với tư cách quản trị viên.
  • Nhấp Admin -> Manage Users.
  • Tìm kiếm người dùng bạn muốn khôi phục.
  • Nhấp Display deleted users.
  • Nhấp biểu tượng mũi tên trên hàng của người dùng.
  • Nhấp Restore để xác nhận.
Khi ENABLE_CRON_RESOURCE_DELETION được đặt thành true, các tài khoản bị xóa mềm có thể được khôi phục trong vòng 90 ngày. Sau 90 ngày, không thể khôi phục tài khoản.

Đếm số người dùng

Bạn có thể lấy số lượng người dùng qua giao diện quản trị tại https://you-instance-url/admin/user#license. Để kiểm tra và xuất dữ liệu theo cách lập trình, các ví dụ sau có thể hữu ích. Tổng số người dùng:
Total number of users
Tổng số người dùng khi dùng endpoint metrics:
Num active users from metrics
Tổng số người dùng đang hoạt động (ví dụ: người dùng hoạt động trong vòng 365 ngày qua):
Total number of active users

Cập nhật thông tin tài khoản người dùng

Cách thực hiện cập nhật tài khoản phụ thuộc vào việc SSO có được bật hay không.
  • Nếu không sử dụng SSO:
    • Quản trị viên có thể sửa đổi thông tin tài khoản người dùng qua Admin -> Manage Users (email, tên, họ và tạo liên kết đặt lại mật khẩu).
    • Người dùng thông thường có thể tự cập nhật thông tin của mình qua Account -> Account Settings (bao gồm đổi mật khẩu và tạo token xác thực Git).
  • Nếu sử dụng SSO:
    • Ayakaleaf Pro có thể được cấu hình để cập nhật tên và họ của người dùng khi đăng nhập dựa trên hệ thống xác thực.
    • Khi OVERLEAF_SAML_UPDATE_USER_DETAILS_ON_LOGIN hoặc OVERLEAF_LDAP_UPDATE_USER_DETAILS_ON_LOGIN là true, biểu mẫu thông tin người dùng tại https://your-instance-url/user/settings sẽ bị vô hiệu hóa và tên/họ chỉ có thể được đặt trong hệ thống quản lý định danh của bạn.
Để biết thêm chi tiết, hãy xem:

Hỏi & Đáp

Trả lời: Không có HTTP API cho việc này. Tạo tài khoản bằng script create-user ở trên (không có --admin), hoặc trong Admin → Manage Users bằng Create account. Khi đặt EXTERNAL_AUTH, biểu mẫu đó có tùy chọn Log in with SSO, tạo tài khoản không có mật khẩu cục bộ và không có email hay liên kết kích hoạt: hộp thoại đóng sau khi nhấp Create. Ở lần đăng nhập LDAP, SAML hoặc OIDC đầu tiên, người dùng nhận tài khoản hiện có cùng email thay vì tài khoản mới, xem Tài khoản và mật khẩu.
Trả lời: Không. Không có chức năng xuất hoặc nhập tài khoản người dùng, cả trong Admin → Manage Users lẫn dưới dạng script. Các tài khoản được lưu trong MongoDB, vì vậy hãy sao lưu và khôi phục chúng bằng bản sao lưu MongoDB. Script export-user-projects.mjs xuất các dự án của người dùng dưới dạng tệp zip, không phải tài khoản, xem Xuất dự án.
Trả lời: Liên kết mà create-user in ra có hiệu lực trong 7 ngày, và nó hoạt động mà không cần SMTP vì bạn sao chép nó từ đầu ra. Để lấy một liên kết mới, hãy chạy lại create-user với cùng email. Đối với một tài khoản đã tồn tại, lệnh này chỉ in ra một liên kết mới, nhưng nó cũng đặt cờ admin của tài khoản theo --admin, vì vậy hãy giữ --admin khi bạn chạy nó cho một quản trị viên.Quản trị viên cũng có thể lấy liên kết đặt lại mà không cần email: trong Admin → Manage Users, nhấp biểu tượng ổ khóa trên hàng của người dùng, rồi Send reset link, và sao chép liên kết từ hộp thoại. Liên kết có hiệu lực 1 giờ, xem Gửi liên kết kích hoạt hoặc đặt lại.Hoặc đặt mật khẩu trực tiếp: nhấp vào tên người dùng, rồi biểu tượng bút chì, nhập New password có ít nhất 8 ký tự và nhấp Save. Tài khoản chỉ đăng nhập qua LDAP, SAML hoặc OIDC không thể nhận mật khẩu theo cách nào.

Cập nhật lần cuối 4 tháng trước Trang tài liệu này chứa các liên kết đến hướng dẫn và trang cấu hình bên ngoài. Tất cả các liên kết và tham số truy vấn được giữ nguyên như trong nội dung gốc.
Lần sửa đổi cuối 13 tháng 11, 2026