Daemon 部署与管理

独立 daemon 提供 HTTP 与 WebSocket 服务。根据个人后台、调试或系统服务场景选择生命周期。

本页内容

启动、查看与停止

独立后台的常规生命周期
acecode daemon
acecode daemon status
acecode daemon stop

不带子命令表示后台启动,start 是兼容别名。启动成功时输出实际 Web UI 地址。未指定 cwd 时使用执行命令的目录;需要其他起点时传入 --cwd=路径。

前台调试使用 acecode daemon --foreground,日志同时输出到终端。不要在仍有需要保留的活动任务时重复启动或停止后台;先检查状态和当前使用者。

端口、运行目录与远程访问

后台监听固定回环地址 127.0.0.1。默认端口为 12399,主配置中的 web.port 可覆盖默认值,命令行 --port 的优先级更高。端口冲突会拒绝启动,不会自动寻找其他端口。

参数作用
--cwd=PATH选择起始工作目录。
--port=N覆盖本次 Web 监听端口。
--run-dir=PATH隔离 PID、心跳、端口与 Token 等运行文件。
--static-dir=PATH从指定目录提供前端静态资源。
--question-policy=ask需要提问时等待用户回答。
--question-policy=deny不等待问题回答,返回自动处理指引。
--question-policy=timeout:60提问等待指定秒数,超时后按策略选择。

自定义运行目录的后台,执行 status 和 stop 时也应使用同一运行目录。隔离运行目录不会自动隔离全部全局配置和用户数据。桌面保留的 desktop-shared 目录由桌面生命周期管理,不应用作任意独立进程的目录。

远程 Web 使用独立受管理代理,按远程 Web 流程开启。完全访问权限不取消所有提问;无人值守服务应同时明确工具权限与问题策略。

运行身份与日志

普通运行文件位于数据目录的 run 下,包含 daemon.pid、daemon.port、daemon.guid、heartbeat 和 token。检查进程时联合看 PID、GUID、心跳时间与健康响应,不能只凭某个文件存在就认定后台健康。

日志按日期写入 logs/daemon-日期.log。共享问题描述时只提供必要片段并遮挡凭据。Token 是访问凭据,不能放到公开仓库或监控截图。

桌面托管后台另有协议与身份校验,兼容实例才会复用。它与独立命令行后台的回收范围不同,参见桌面后台排错。

Windows 服务模式

需要开机后在用户登录前运行时,可在管理员 PowerShell 中安装服务。服务以 LocalSystem 身份运行,使用 ProgramData 下的数据,不自动沿用个人用户的模型配置。

管理员 PowerShell · 安装与启动
acecode service install
acecode service start
acecode service status

先为服务身份准备正确配置和可访问目录,再验证健康与模型请求。个人映射盘、环境变量和凭据可能不适用于 LocalSystem。维护时先停止服务,确认不再需要该服务后卸载:

管理员 PowerShell · 停止与卸载服务
acecode service stop
acecode service uninstall

移除服务注册不等于删除所有项目与用户数据。需要清理时按明确的数据目录逐项备份和处理。

搜索全部帮助文档