> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Truy cập công khai

> Cho phép khách, khách truy cập chưa đăng nhập và người dùng mới truy cập một triển khai Kubernetes.

Quyền truy cập của khách vào các dự án được chia sẻ, các trang công khai và việc tự đăng ký được bật bằng các biến môi trường mà dịch vụ **web** đọc; sau đó dịch vụ real-time phục vụ khách thông qua session của họ. Mỗi công tắc mở ra những gì được mô tả trong [Truy cập công khai](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/authentication/public-access.md).

| | |
| - | - |
| Dịch vụ | web (và real-time cho khách trong trình soạn thảo), trong mọi pod Ayakaleaf Pro; được đọc khi web khởi động |
| Pod → bên ngoài | máy chủ SMTP, khi việc đăng ký gửi email kích hoạt |
| Trạng thái | token truy cập của khách trong session, giới hạn tốc độ đăng ký trong Redis |
| Tác vụ định kỳ | không có |

### Cấu hình

Thêm các công tắc bạn cần vào ConfigMap `overleaf-env`:

```yaml title="30-config.yaml (additions)" theme={null}
  # Guests open link-shared projects without an account
  OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING: "true"
  # Signed-out visitors may open /learn, /templates, /devs and view links
  OVERLEAF_ALLOW_PUBLIC_ACCESS: "true"
  # Self-registration: "true", or only some domains
  OVERLEAF_ALLOW_PUBLIC_REGISTRATION: "@example.com, @*.uni.example"
```

```bash theme={null}
kubectl apply -f 30-config.yaml
kubectl -n overleaf rollout restart deployment/overleaf     # or statefulset/overleaf
```

Hãy đặt mọi giá trị trong dấu nháy. Các giá trị bắt đầu bằng `@` bắt buộc phải nằm trong dấu nháy trong YAML, nếu không `kubectl apply` sẽ từ chối tệp.

Việc đăng ký giới hạn theo tên miền sẽ gửi email kích hoạt, vì vậy [Gửi email](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/kubernetes/email-delivery.md) phải hoạt động từ các pod: đặt máy chủ SMTP vào ConfigMap và `OVERLEAF_EMAIL_SMTP_PASS` vào Secret.

### Nhiều replica

Không cần gì thêm. Quyền truy cập của khách vào một dự án được lưu trong session trên Redis, nên trình soạn thảo hoạt động trên bất kỳ replica nào mà load balancer chọn.

### Đã kiểm thử trên Kubernetes

Trên Kubernetes 1.37, các bài kiểm thử end-to-end của chúng tôi cho truy cập công khai đều đạt: trên một replica, tự đăng ký với `OVERLEAF_ALLOW_PUBLIC_REGISTRATION` được đặt thành `true`, thành một tên miền, thành nhiều tên miền với wildcard tên miền con và thành `@*`, kèm email kích hoạt cho các chế độ theo tên miền (43 trường hợp); khách truy cập chưa đăng nhập trên `/devs` và một đoạn mã đã gửi được giữ lại qua bước đăng nhập với `OVERLEAF_ALLOW_PUBLIC_ACCESS` (2 trường hợp); một khách chưa đăng nhập trong một dự án được chia sẻ qua liên kết khi bật cả hai công tắc (3 trường hợp); và trên ba replica phía sau HAProxy, OIDC kết hợp với truy cập công khai (1 trường hợp).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.