> ## Documentation Index > Fetch the complete documentation index at: https://docs.nekohub.fengying.xin/llms.txt > Use this file to discover all available pages before exploring further. # 环境变量 > NekoHub 部署时可用的环境变量参考。 NekoHub 通过环境变量完成运行时配置。使用 Docker Compose 时，通常从 `.env.example` 复制出 `.env` 再按需修改。 ```bash theme={null} cp .env.example .env ``` 不要把 `.env.example` 的占位值直接用于生产环境。尤其要替换 `Auth__Jwt__Secret`、`Auth__BootstrapSuperAdmin__Password` 和所有 API key。 *** ## 数据库 PostgreSQL 连接串。 ```env theme={null} Persistence__Database__ConnectionString=Host=postgres;Port=5432;Database=nekohub;Username=nekohub;Password=yourpassword;Pooling=true ``` 数据库 provider。当前代码只支持 `postgresql`。 *** ## 鉴权：JWT 以下变量控制 JWT 的签发与校验。 JWT 签名密钥，至少 32 个字符。生产环境应使用强随机值。 ```env theme={null} Auth__Jwt__Secret=your-random-secret-at-least-32-chars ``` JWT 的 `iss`（issuer）声明。由后端写入并校验。 JWT 的 `aud`（audience）声明。由后端写入并校验。 Access token 有效期（分钟）。 Refresh token 有效期（天）。 *** ## Bootstrap 超级管理员只有当数据库里还没有 `SuperAdmin` 时，NekoHub 才会执行 bootstrap。之后即使你修改了这两个环境变量，也不会覆盖现有超级管理员。首次部署时要创建的 `SuperAdmin` 用户名。 ```env theme={null} Auth__BootstrapSuperAdmin__Username=admin ``` 首次部署时要创建的 `SuperAdmin` 密码。 ```env theme={null} Auth__BootstrapSuperAdmin__Password=change-this-to-a-strong-password ``` *** ## API key API key 面向脚本、自动化和 MCP。浏览器后台不使用 API key 登录。是否启用 API key 鉴权。关闭时，`/mcp` 以及所有使用 Bearer API key 的请求都会被拒绝。第一个 API key。启用后至少要配置一个；更多 key 使用 `Keys__1`、`Keys__2` 追加。 ```env theme={null} Auth__ApiKey__Keys__0=your-strong-random-api-key ``` *** ## 存储运行时默认存储 provider，支持 `local`、`s3`、`github-repo`。更多 provider 细节见 [存储选项](/configuration/storage-options)。用于拼接公开内容地址的 URL 前缀，浏览器必须能访问到。 ```env theme={null} Storage__PublicBaseUrl=http://localhost:5121/content ``` 使用 `local` provider 时的文件系统目录。容器部署时要挂持久化卷。 *** ## 前端浏览器访问 NekoHub API 的基础地址。前后端同域反代时可留空。 ```env theme={null} FRONTEND_VITE_API_BASE_URL=https://api.nekohub.example.com ``` Vite preview 允许的 Host。可以设为 `true` 允许全部，或写成逗号分隔列表。前端允许上传的最大体积（字节）。默认 10 MB。前端容器监听端口。