Uptime Kuma

环境要求

• Docker 与 Docker Compose（Docker Compose 方式）或 Docker 引擎（docker run 方式）
• 选择非 Docker 安装时需要：Node.js >= 20.4、Git、pm2（后台运行）
• 支持的平台：主流 Linux 发行版（Debian/Ubuntu/Fedora/ArchLinux 等）、Windows 10 (x64) 或 Windows
• 数据目录必须位于本地目录或卷上，不支持 NFS 等网络文件系统

安装与启动步骤

1. 1创建并进入目录

   新建一个目录存放 compose 配置文件，并切换到该目录中，后续命令都在此目录执行。

   mkdir uptime-kuma
   cd uptime-kuma

   复制

2. 2下载 compose 文件

   从官方仓库下载 compose.yaml 到当前目录，不要手动改写文件名，保持默认即可。

   curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

   复制

3. 3后台启动服务

   用 docker compose 以守护进程方式启动 Uptime Kuma，首次会拉取镜像，稍等片刻。

   docker compose up -d

   复制

4. 4或用单条 docker 命令

   如果不想用 compose，可直接运行官方镜像：映射 3001 端口、挂载数据卷、容器名 uptime-kuma。

   docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

   复制

5. 5限制仅本机访问

   出于安全考虑只想让本机访问时，把端口映射改为绑定 127.0.0.1 即可，其余参数保持不变。

   docker run -d --restart=always -p 127.0.0.1:3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

   复制

6. 6浏览器完成初始化

   打开 http://localhost:3001（或 http://你的服务器IP:3001），按界面提示创建管理员账号并登录。

7. 7非 Docker 方式安装

   克隆仓库并执行 npm run setup 安装依赖；README 仅给出到 setup 与 pm2 安装这一步，完整后台启动命令请参考官方 How-to-Install 文档。

   git clone https://github.com/louislam/uptime-kuma.git
   cd uptime-kuma
   npm run setup
   npm install pm2 -g && pm2 install pm2-logrotate

   复制

关键配置

如何确认成功

执行 docker ps 能看到 uptime-kuma 容器处于运行状态，浏览器访问 http://localhost:3001 能正常打开界面并进入初始化页面。

常见问题

注意事项

• 数据目录务必挂载到本地目录或卷，NFS 不受支持，删容器不等于删数据，但漏挂卷会丢数据。
• 默认监听所有网络接口（3001 端口），暴露公网前建议改用 127.0.0.1 绑定或加反向代理与鉴权。
• 非 Docker 方式依赖 Node.js >= 20.4、Git 和 pm2；README 只给出到 npm run setup 与安装 pm2 的步骤，完整后台启动命令以官方 How-to-Install Wiki 为准。
• 更多安装选项与反向代理配置请查阅 https://github.com/louislam/uptime-kuma/wiki 中的 How-to-Install 页面。