部署配置字典
唯一手工配置源是 deploy/agentos.env，由 node tools/setup.mjs init --mode local 或 --mode deploy 生成。 修改后 prepare，再重启进程/重建容器。不要手改 agentos.properties、agentos.runtime.env 和前端模式文件。
先看能照填的 Demo，再查参数
第一次安装先看本地启动教程：MySQL 127.0.0.1:3306、空库 ruoyi_office_agentos、独立账号 agentos、Redis 127.0.0.1:6379/5、平台后端 48080、平台前端 5800、智能体前端 5666，并提供 GPT / DeepSeek 两套填写示例。演示密码仅限本地，不是产品内置账号。
例如选 GPT，三个模型字段分别填 https://api.openai.com、你自己的 API Key、gpt-4.1-mini；选 DeepSeek 则填 https://api.deepseek.com、DeepSeek Key、deepseek-flash。二选一替换，不重复追加；模型联调边界见教程。
仓库的 deploy/examples/local-gpt.env.example 和 deploy/examples/local-deepseek.env.example 是可复制的配置片段，不会自动加载；先 init，再替换 deploy/agentos.env 中对应行，自动生成的 OAuth Secret、加密密钥保持不动。Docker 部署必须使用容器可达的宿主机 IP 或服务名，不能照抄本机地址。
参数速查
| 分类 | 参数 | 说明 |
|---|---|---|
| 数据库 | MYSQL_URL / MYSQL_USERNAME / MYSQL_PASSWORD | 独立 AgentOS 库，非平台库 |
| Redis | REDIS_HOST / REDIS_PORT / REDIS_DATABASE / REDIS_PASSWORD | 独立 database；端口默认 6379，密码按服务要求 |
| 默认模型 | AGENTOS_MODEL_URL / AGENTOS_MODEL_KEY / AGENTOS_MODEL | 启动前配一次即可；默认拼接 /v1/chat/completions，不重复追加 |
| 平台后端 | AGENTOS_MAINLINE_URL | 后端可达地址，不含 /admin-api；容器部署不用 localhost |
| 平台前端 | AGENTOS_MAINLINE_WEB_URL | 浏览器访问平台的地址 |
| 智能体前端 | AGENTOS_WEB_URL | 本地 http://localhost:5666/，生产 https://客户域名/ai/ |
| 租户与角色 | AGENTOS_TENANT_ID / AGENTOS_ADMIN_ROLE_ID | 首次初始化用，核对平台实际值 |
| OAuth | AGENTOS_CLIENT_ID / AGENTOS_CLIENT_SECRET | ID 固定 agentos，Secret 自动生成并同源渲染 SQL |
| 加密 | AGENTOS_ENCRYPT_KEY | 自动生成 16 位，备份并保留，不能每次重启生成 |
| 镜像 | AGENTOS_SERVER_IMAGE / AGENTOS_WEB_IMAGE | 源码部署用本地标签，镜像部署用交付版本 |
| 宿主端口 | AGENTOS_SERVER_PORT / AGENTOS_WEB_PORT | Docker 映射端口 48091 / 18080；改后同步 Nginx |
| OCR | AGENTOS_OCR_URL / AGENTOS_OCR_TOKEN / AGENTOS_OCR_MODEL | 可选，匹配专用服务协议 |
| 文件白名单 | AGENTOS_OCR_ALLOWED_FILE_HOSTS | 启用 OCR 才必填，逗号分隔域名 |
| ASR | AGENTOS_ASR_URL / AGENTOS_ASR_KEY / AGENTOS_ASR_MODEL | 可选，未配置不影响文字 |
| License / 演示码 | AGENTOS_LICENSE_ENABLED / AGENTOS_DEMO_GATE_ENABLED | 客户保持 false，无需公钥或体验码 |
| 实验数据库 | MYSQL_ROOT_PASSWORD | 仅显式使用 compose.lab.yaml 时填写 |
KEY=value 或单引号包裹值，不支持内嵌单引号、双引号、换行、${...} 插值。 生成文件保留 $、#、& 等普通字符；不要 source 原始文件，不打印密钥。Linux 权限 600，Windows 限制目录 ACL。
本地也用 prod profile，在 AgentOS 根目录读取 agentos.properties；容器通过 Compose 注入 runtime.env。 同名环境变量优先于文件，迁移时清理旧覆盖项。私密配置不应放 resources 或打进 JAR。
默认模型是基础可用线路，不需要再在页面重复配置。租户页面模型优先，未配置时回落默认模型。 只有具备 agentos:model:update 的管理员可以修改页面模型。 已有安装沿用原密钥和数据，按版本增量升级，不执行首次空库流程。
