项目常见问题

项目启动失败

点击「日志」查看错误信息。 常见原因：

权限问题

项目目录应在 /opt/ace/projects/ 下，所有者为 www：

chown -R www:www /opt/ace/projects/项目名

如果部署在 /root 下，需使用 root 用户运行（不推荐）。

找不到命令

如 node: No such file or directory，说明环境变量未配置。

解决方法：

1. 在「编辑」->「依赖」中关联运行环境
2. 或在「运行设置」->「环境变量」中添加 PATH

端口被占用

修改应用监听端口，或停止占用端口的进程：

lsof -i:3000  # 查看占用端口的进程

配置环境变量

「编辑」->「运行设置」->「环境变量」，点击「添加」。

常用配置：

• NODE_ENV=production
• PORT=3000

预启动命令

在项目启动前执行，如安装依赖：

• Node.js：npm install 或 yarn
• Python：pip install -r requirements.txt
• Go：go build

查看项目日志

1. 面板：项目列表点击「日志」
2. 命令行：journalctl -u ace-project-项目名 -f

项目自动重启

在「运行设置」中配置：

• 重启策略：失败时重启 / 总是重启 / 不重启
• 重启间隔：两次重启之间的等待时间
• 最大重启次数：防止无限重启

反向代理配置

创建项目时开启「反向代理」，会自动创建一个反向代理网站。

手动配置：创建反向代理网站，上游地址填 http://127.0.0.1:项目端口。