配置文件说明
1 功能简介
AI 网关的业务配置（上游账号、模型组、密钥等）在管理界面维护；部署参数（端口、初始密码、代理等）通过 docker run 的环境变量与数据目录指定。
2 配置与数据目录
默认数据目录为 /opt/ai-gateway，容器名示例为 1panel-ai-gateway。主要路径如下：
表 1 主要文件与目录
| 文件 / 目录 | 默认路径 | 说明 |
|---|---|---|
| 数据目录 | /opt/ai-gateway | 持久化数据；重建容器须保留 |
| SQLite 库 | /opt/ai-gateway/data/db/ai-gateway.db | 默认单机数据库 |
| 凭据密钥 | /opt/ai-gateway/data/security/credential.key | 丢失后已存凭据无法解密 |
3 修改与生效
修改前先备份数据目录：
cp -a /opt/ai-gateway /opt/ai-gateway.bak.$(date +%F)
变更端口或环境变量时，先停删旧容器（不要删除 /opt/ai-gateway），再按新参数重建并继续挂载原目录：
docker stop 1panel-ai-gateway
docker rm 1panel-ai-gateway
docker run --pull always -d \
--name 1panel-ai-gateway \
--restart unless-stopped \
-p 8080:8080 \
-v /opt/ai-gateway:/opt/ai-gateway \
1panel/ai-gateway
保留数据目录
重建容器时必须继续挂载 /opt/ai-gateway。删除该目录或丢失 credential.key 会导致数据或凭据不可用。
4 参数说明
部署相关参数如下（业务侧配置在管理界面维护）：
表 2 参数说明
| 参数名称 | 默认值 | 可选项 | 说明 |
|---|---|---|---|
| AI_GATEWAY_INITIAL_ADMIN_PASSWORD | — | — | 初始管理员密码；显式传入时不会写入启动日志，见 在线安装 |
| -p 主机端口:8080 | 8080 | — | 容器内端口为 8080，通过端口映射对外暴露 |
| -v /opt/ai-gateway:/opt/ai-gateway | /opt/ai-gateway | — | 数据目录挂载；重建容器须保留 |
| 数据库模式 | SQLite | SQLite PostgreSQL | 默认单机 SQLite；其他模式见 部署说明 |
忘记管理员密码时，自 v1.0.1 起可使用 reset-admin-password，见 重置管理员密码。