配置你的实例

你实例的所有配置都通过 安装过程 中创建的 .env 文件完成。本页按用途分组，介绍运维者实际会用到的设置项，而不是逐一列出模板中的每一个变量。

修改 .env 之后，需要重新创建容器才能生效：

docker compose up -d

身份与 URL

• APP_NAME 是界面和邮件中显示的名称，默认值为 Kollek。
• APP_URL 是你实例的公开访问地址。邮件中的链接都基于它生成，因此必须设置成用户实际访问的地址。
• APP_PORT 是 web 容器对外暴露的主机端口，默认是 8000。

应用密钥

APP_KEY 用于加密静态敏感数据。你只在安装时设置一次，之后不要随意更改。这个设置足够重要，专门有 独立的一页 来讲解，其中还介绍了 APP_PREVIOUS_KEYS 密钥轮换机制。

数据库

DB_DATABASE、DB_USERNAME、DB_PASSWORD 和 DB_ROOT_PASSWORD 用于配置内置的 MySQL 容器。在首次启动前，请将两个密码都从占位值改为真实密码。RUN_MIGRATIONS 控制 web 容器是否在启动时自动迁移数据库（默认是 true）。

邮件

MAIL_MAILER 决定邮件如何从你的实例发出，默认值是 log。

文件存储

FILESYSTEM_DISK 默认值为 local：上传的照片和文档存储在 storage-data 数据卷中。如果想改用兼容 S3 的对象存储，将其设置为 s3，并填写 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION、AWS_BUCKET，以及非 AWS 服务商所需的 AWS_ENDPOINT 变量。无论使用哪种方式，文件都通过带账户校验的私有路由提供给用户，而不会以公开 URL 的形式暴露。

日常维护

• TRASH_RETENTION_DAYS 决定软删除的对象在 回收站 中保留多久，之后会被每晚的清理任务永久删除。默认值是 30 天。
• ACCOUNT_DELETION_NOTIFICATION_EMAIL 是当用户删除自己的账户，或被 非活跃用户清理 移除时收到通知的邮箱地址。建议填写你自己的邮箱，这样有人离开时你不会毫无察觉。

公开的营销站点

SHOW_MARKETING_SITE 默认值为 false，也就是说你的实例只提供应用本身。将其设置为 true 后，还会提供公开的营销页面，以及 /docs/api 上自动生成的 API 参考文档。大多数私有实例都会关闭它，只有当你的开发者需要本地访问 API 参考文档时才建议开启。

这些页面对每位访客都是一样的，只有在你重新部署时才会变化，因此每个页面都会带着缓存头发出：浏览器保存五分钟，实例前面的任何 CDN 保存一周。把 CACHE_PUBLIC_PAGES 设为 false 就不再发送这些头。无论哪种情况，实例本身都不会缓存任何东西。

如果你通过 Cloudflare 提供站点，还要设置 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ZONE_ID。当公开站点展示的内容发生变化时，实例正是靠它们告诉 Cloudflare 丢弃已保存的副本，无论是实例自己触发，还是从面板触发。直接对外提供服务的实例请把它们留空：前面没有什么可清除的。

无论哪种设置，实例都会自己响应 /robots.txt，而不是从磁盘提供一个文件。公开站点开启时，它会把抓取工具指向 /sitemap.xml，其中列出了每一个公开页面，以及它所提供的每一种语言。公开站点关闭时，它会告诉所有抓取工具远离整个主机，因为私有实例上没有值得索引的内容。

垃圾注册防护

没有什么能阻止机器人填写你的注册表单，而在任何人都能访问的实例上，这种事迟早会发生。TURNSTILE_ENABLED 会在登录、注册和重置密码这三个表单上加载 Cloudflare Turnstile 组件，没有通过验证的提交根本到不了应用本身。

它默认是 false，对于你认识每一个登录者的私有实例来说，这就是正确的选择。要开启它，先在你的 Cloudflare 账户中创建一个 Turnstile 组件，然后把 TURNSTILE_ENABLED 设为 true，把它给你的公开密钥填进 TURNSTILE_SITE_KEY，私密密钥填进 TURNSTILE_SECRET_KEY。只打开开关并不能保护任何东西：缺少这两个密钥，没有访客能通过这项验证。

不需要配置的部分

会话（SESSION_DRIVER）、缓存（CACHE_STORE）和队列（QUEUE_CONNECTION）默认都基于数据库存储。这些默认值对提供的服务栈来说已经是正确的，不需要额外添加 Redis 或其他服务。除非你清楚知道自己为什么要改，否则不要动它们。

接下来去哪里

• 在 设置邮件发送 中让真正的邮件发送起来。
• 在 应用密钥与加密 中了解你必须保护好的这个密钥。
• 设置好 备份。