> ## 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.

# 公开访问

> 如何让访客、未登录用户和新用户访问你的 Overleaf 实例？

你可以通过三种方式向没有账户的用户开放你的 Overleaf 实例：

* [#project-access](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#project-access "mention")：允许访客无需登录即可打开共享的项目链接
* [#page-access](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#page-access "mention")：允许未登录的访问者浏览 `/learn`、`/templates` 和 `/devs` 等页面
* [#public-registration](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#public-registration "mention")：允许用户自行注册，并可选择启用激活邮件以及限制为特定的邮箱域名

### 项目访问

> [!NOTE]
>
> 默认情况下，即使用户获得了项目分享链接，也必须先**登录**才能加入协作项目的编辑会话。

要允许匿名访问通过链接分享的项目，请同时设置以下两个变量：

```dotenv title="config/variables.env" theme={null}
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING=true
OVERLEAF_ALLOW_PUBLIC_ACCESS=true
```

`OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` 为通过链接分享的项目启用匿名读写。

`OVERLEAF_ALLOW_PUBLIC_ACCESS` 可防止未认证的用户被重定向到登录页面。

如果只需要只读访问，只设置 `OVERLEAF_ALLOW_PUBLIC_ACCESS=true` 即可：访客无需登录即可打开查看链接（`/read/...`），而编辑链接仍会要求他们登录。

使用 `bin/up` 重新创建容器。然后在隐私窗口中打开链接分享 URL 进行验证。

### 页面访问

默认情况下（未设置 `OVERLEAF_ALLOW_PUBLIC_ACCESS`），除登录和注册页面外，**所有**页面都会将未登录的访问者重定向到登录页面。这也包括那些本应公开的页面，因此指向这些页面的链接只对已登录的用户有效。

设置 `OVERLEAF_ALLOW_PUBLIC_ACCESS=true` 后，未登录的访问者可以打开：

| 页面 | 依赖条件 |
| - | - |
| 位于 `/learn` 的 LaTeX 帮助（参见 [adding-latex-user-help.md](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/adding-latex-user-help.md "mention")） | `OVERLEAF_PROXY_LEARN=true` |
| 位于 `/templates` 的模板库、模板页面、预览和 ZIP 下载（参见 [templates.md](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/templates.md "mention")） | `OVERLEAF_TEMPLATE_GALLERY=true` |
| 位于 `/devs` 的 Overleaf Import API 页面（参见 [overleaf-import-api.md](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/integrations/overleaf-import-api.md "mention")） | — |

它还允许 [#signed-out-visitors](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/integrations/overleaf-import-api.md#signed-out-visitors "mention") 保留未登录访问者提交的表单，直到其登录为止。

项目列表、编辑器以及创建项目（包括从模板或通过 Import API 创建）仍然需要登录。

### 公开注册

公开注册功能仅在 [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) 中提供。

> [!CAUTION]
>
> 请注意，一旦启用公开注册，**任何**能够访问你的 Overleaf 实例的人都可以注册为用户。
>
> 设置为 `true` 时，注册过程不会验证邮箱地址，因此请仅在内网或受信任的环境中使用，或者改用[通过激活邮件注册](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#registration-with-activation-email)。
>
> 在启用 OIDC 的实例上，请不要使用 `true`：任何人都可以在同事首次 OIDC 登录之前使用该同事的邮箱注册，这会导致同事被关联到该账户。请使用[通过激活邮件注册](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/authentication/public-access.md#registration-with-activation-email)或不开放公开注册，参见[账户与密码](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/authentication#accounts-and-passwords)。

默认情况下，社区版和 Overleaf Pro 均不允许公开注册。

要启用该功能，请在 `config/variables.env` 中添加：

```dotenv title="config/variables.env" theme={null}
OVERLEAF_ALLOW_PUBLIC_REGISTRATION=true
```

使用 `bin/up` 重新创建容器。

然后点击 **Sign up** 或访问 `/register`。

![](https://mintcdn.com/ayakaleaf-pro/lO_zpnrk4Y4SPJX1/images/on-premises/image-21.png?fit=max\&auto=format\&n=lO_zpnrk4Y4SPJX1\&q=85\&s=df328bd4564f52213248b497c66b4a5c)

### 通过激活邮件注册

通过激活邮件注册功能仅在 [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) 中提供。用户只需使用邮箱注册，并通过激活邮件中的链接设置密码，因此只有邮箱地址的所有者才能使用该账户。使用域名列表和通配符需要 v6.4.0 或更高版本；更早的版本只接受单个域名，例如 `@example.com`。

启用此功能之前，请先配置邮件发送，否则用户将永远收不到激活邮件。参见[邮件发送](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/email-delivery.md)。

然后在 `config/variables.env` 中添加以下行：

```dotenv title="config/variables.env" wrap theme={null}
OVERLEAF_ALLOW_PUBLIC_REGISTRATION=@example.com,@*.example.org
```

`OVERLEAF_ALLOW_PUBLIC_REGISTRATION` 可以设置为：

| 值 | 谁可以注册 | 是否验证邮箱 |
| - | - | :-: |
| `true` | 任何人，使用邮箱和密码 | 否 |
| `@example.com` | `example.com` 的邮箱地址 | 是 |
| `@*.example.org` | `cs.example.org` 等子域名的邮箱地址，不包括 `example.org` 本身 | 是 |
| `@example.com,@*.example.org` | 所列条目中的任意一项，以逗号分隔 | 是 |
| `@*` | 任何人 | 是 |

域名匹配不区分大小写。若要同时允许某个域名及其子域名，请将两者都列出：`@example.org,@*.example.org`。

### Q\&A

> [accordion] 未登录的编辑者可以对评论做什么？
>
> \*\*回答：\*\*通过编辑链接打开项目的未登录用户获得与编辑者相同的权限，但需要记录操作者身份的操作除外：
>
> | 操作 | 未登录的编辑者 |
> | - | -: |
> | 编辑文本、查看评论和修订 | 是 |
> | 接受修订、切换编辑模式 | 是 |
> | 删除评论或整个讨论串 | 是 |
> | 添加、回复或编辑评论 | 否 |
> | 解决或重新打开评论 | 否 |
>
> 审阅面板仍会向他们显示 **Resolve** 按钮，但解决操作会失败并显示错误消息。
>
> 通过查看链接打开项目的用户完全看不到评论，请参阅[角色与权限](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/user-and-project-management/roles-and-permissions.md#collaborating)。

> [accordion] 可以在不使用邮件或使用邀请码的情况下添加用户和邀请协作者吗？
>
> \*\*回答：\*\*没有邀请码功能，但可以在不使用邮件的情况下添加用户。在 **Admin → Manage Users** 中，点击 **Create account**。然后打开该用户的 **Info**：其中会显示有效期为一周的激活链接，你可以复制该链接并自行发送给用户。要分享项目，请邀请已有账户的用户：邀请也会显示在他们的项目列表中，因此他们无需邮件即可接受邀请。没有账户的人只能通过邮件收到邀请，因此请先为他们创建账户。


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