Uptime-Kuma 项目端口配置指南

端口配置的重要性

在部署监控系统时，端口配置是一个关键环节。Uptime-Kuma 默认使用3001端口，这个端口在某些环境中可能已被其他服务占用，如Invidious、mstream等常见自托管应用。端口冲突会导致服务无法正常启动，因此了解如何修改端口配置至关重要。

非Docker环境下的端口修改方法

对于直接通过Node.js运行Uptime-Kuma的用户，有以下几种方式可以修改服务端口：

1. 通过命令行参数修改

最直接的方式是在启动命令中添加参数：

node server/server.js --host=127.0.0.1 --port=8080

这种方式简单直接，适合临时测试或开发环境使用。

2. 使用PM2进程管理器

对于生产环境，推荐使用PM2来管理Uptime-Kuma进程。配置端口需要通过PM2的生态系统文件或环境变量：

创建或修改PM2配置文件（如ecosystem.config.js）：

module.exports = {
  apps: [{
    name: "uptime-kuma",
    script: "server/server.js",
    env: {
      PORT: 3066
    }
  }]
}

然后通过PM2启动：

pm2 start ecosystem.config.js

3. 通过环境变量文件配置

从1.20.0版本开始，Uptime-Kuma支持通过.env文件配置。在项目根目录下创建.env文件，内容如下：

PORT=3066
HOST=127.0.0.1

这种方式配置的端口会在服务启动时自动加载。

配置注意事项

1. 防火墙设置：修改端口后，确保防火墙或安全组规则允许新端口的访问
2. 反向代理：如果使用Nginx等反向代理，需要相应更新代理配置
3. 持久化：使用PM2时，记得保存配置（pm2 save）以确保重启后设置仍然有效
4. 权限问题：低于1024的端口通常需要root权限

最佳实践建议

对于生产环境部署，建议采用以下方案组合：

1. 使用PM2进行进程管理
2. 通过.env文件配置端口等参数
3. 配合Nginx反向代理并启用HTTPS
4. 配置系统服务（systemd）实现开机自启

通过合理配置端口，可以确保Uptime-Kuma监控服务稳定运行，避免与其他服务产生冲突，同时保障系统安全性。