From f75c6883edc8dc431fc04cac1dee22aa2515e0d5 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Tue, 25 Aug 2026 14:59:58 +0800 Subject: [PATCH] docs: document Portal YAML runtime settings (#56) --- Deployment-and-Operations.-.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Deployment-and-Operations.-.md b/Deployment-and-Operations.-.md index e1b7ea5..671e99c 100644 --- a/Deployment-and-Operations.-.md +++ b/Deployment-and-Operations.-.md @@ -111,7 +111,7 @@ MVP-0 的终端用户会话保存在单个 portal 进程内存中，Cookie 只 上传先在应用层校验，再在 generation 事务回调中保存带 owner/generation metadata 的文件。事务失败只清理本请求保存的 key；存储根目录不能作为 nginx/static 目录暴露。 ## MVP-0 worker 已实现配置与退出行为 -portal 单二进制会同时启动 HTTP server 和内嵌 worker。生产除现有 portal 限制外，还必须显式提供： +portal 单二进制会同时启动 HTTP server 和内嵌 worker。启动必须显式传入 `--config `。下列 Provider/worker 参数以 YAML 为基础值，同名环境变量可逐项覆盖： | 变量 | 约束 | |---|---| @@ -189,7 +189,7 @@ Provider API Key 由授权管理员通过管理端写入 `provider_credentials.a ## Windows 本机 Supervisor 运行 -`D:\supervisor` 是当前 Windows 本地常驻运行方式，不替代生产反向代理或正式服务管理器。通过 `scripts/install-supervisor.bat` 生成三个独立实例：Portal、Admin API 和 Admin UI。Supervisor program 配置只保存进程路径、配置路径、Host/Port 与日志策略；Portal 凭据继续从 `portal.environment_file` 指向的受保护 PowerShell 文件读取，Admin 敏感值继续只存在于 `admin/config/settings.yml`。 +`D:\supervisor` 是当前 Windows 本地常驻运行方式，不替代生产反向代理或正式服务管理器。通过 `scripts/install-supervisor.bat` 生成三个独立实例：Portal、Admin API 和 Admin UI。Supervisor program 配置只保存进程路径、配置路径、Host/Port 与日志策略；Portal 数据库/Session 配置从 `portal.environment_file` 读取，Provider/worker 参数从 `portal.settings_file` 读取，Admin 敏感值继续只存在于 `admin/config/settings.yml`。 安装或更新：