1. 项目概述为什么要在LattePanda上部署Uptime Kuma最近在折腾我的家庭监控面板手头正好有一台闲置的LattePanda 3 Delta。这玩意儿性能不错功耗也低一直想给它找个正经活儿干。之前用它跑过一些轻量服务但总觉得有点大材小用。直到我开始为家里和工作室的十几个服务从NAS、智能家居网关到自建的各种API的在线状态发愁时才想起来Uptime Kuma这个开源监控神器。Uptime Kuma是什么简单说它就是一个自托管的、颜值在线的服务状态监控面板。你可以把它理解为你所有网络服务的“健康仪表盘”。哪个网站打不开了哪个API响应慢了它都能第一时间通过邮件、钉钉、Telegram等一大堆渠道通知你而且所有监控历史和状态都一目了然地展示在一个漂亮的Web页面上。最关键的是它完全免费、开源数据掌握在自己手里不用担心服务商的限制或隐私问题。那么为什么偏偏要选LattePanda 3 Delta这台小主机来跑它呢这里有几个很实际的考虑。首先24小时低功耗运行是刚需。LattePanda 3 Delta的整机功耗通常在10-20瓦之间比一台常年开机的台式机或笔记本省电得多非常适合作为家庭实验室的“基础设施”主机。其次性能足够且有盈余。它搭载的Intel Celeron N5105处理器和8GB内存运行一个Docker容器化的Uptime Kuma绰绰有余甚至还能同时跑点别的轻量服务。最后物理部署灵活。这台小主板尺寸迷你可以轻松塞进弱电箱、电视柜后面或者用3D打印个外壳挂在墙上不占地方也没有风扇噪音的困扰。这个组合本质上是在打造一个完全自主可控、低成本、高可用的核心网络监控节点。它不再只是一个玩具项目而是能真正融入日常运维成为你数字生活里一个安静而可靠的“守望者”。2. 环境准备与系统选型在LattePanda上部署任何服务第一步也是最重要的一步就是打好系统基础。一个稳定、高效且易于维护的操作系统是后续所有操作顺利进行的保障。2.1 操作系统选择与考量为LattePanda这类x86架构的迷你主机选择系统我们有几个主流方向Windows、Ubuntu Server、Debian或者一些轻量级发行版。经过反复实测我强烈推荐Ubuntu Server 22.04 LTS。理由如下长期支持与稳定性LTS版本提供5年的安全更新和维护避免了频繁升级带来的潜在风险这对于需要7x24小时运行的监控服务至关重要。资源占用与性能Ubuntu Server没有图形界面系统开销极小。安装完成后空闲内存占用通常在500MB以下为Uptime Kuma和其他服务留出了充足的空间。社区与生态拥有最庞大的用户社区和文档支持。无论是遇到驱动问题、网络配置还是Docker安装你几乎都能找到现成的解决方案和讨论。对LattePanda的兼容性Ubuntu的内核对新硬件的支持很好。LattePanda 3 Delta的网卡、声卡、GPIO等组件在Ubuntu 22.04上基本可以开箱即用省去了折腾驱动的麻烦。当然如果你对系统洁癖有更高要求Debian也是极好的选择它在稳定性上更胜一筹但可能需要在驱动和软件包版本上多花一点心思。Windows则不太推荐其后台服务较多资源占用高且对于运行Docker容器不如Linux原生高效和方便。2.2 系统安装与基础配置将Ubuntu Server镜像写入U盘后启动LattePanda并从U盘引导安装。安装过程有几个关键点需要注意分区方案对于监控主机我建议采用手动分区。创建一个单独的/var分区是个好习惯因为Docker的镜像、容器以及Uptime Kuma的数据库默认都存放在这里。给/var分配20-30GB的空间可以避免日后因日志或镜像积累导致根目录爆满。剩下的空间可以挂载到/home或一个专门的数据目录。用户设置务必创建一个具有sudo权限的普通用户例如monitor并禁用root用户的SSH登录。这是最基本的安全加固步骤。网络配置建议在安装时就配置好静态IP地址。因为这台设备将作为监控节点一个固定的IP地址便于我们通过浏览器访问其Web界面也方便在其他设备上配置指向它的DNS或反向代理。记下你为它设置的IP比如192.168.1.200。软件选择在安装类型界面只勾选“OpenSSH server”即可。其他服务我们后续按需安装保持系统纯净。系统安装完成后首先进行更新和基础工具安装sudo apt update sudo apt upgrade -y sudo apt install -y curl wget vim git htop net-toolshtop可以让你直观地查看CPU、内存和进程状态net-tools包含了ifconfig等老牌网络工具在排查问题时很有用。注意首次SSH登录后建议立即修改SSH默认端口如改为2222并配置密钥认证彻底关闭密码登录。这是将设备暴露在家庭网络中的一项重要安全措施。具体操作可以通过编辑/etc/ssh/sshd_config文件实现。3. 核心依赖部署Docker与Docker ComposeUptime Kuma官方推荐使用Docker进行部署这是目前最主流、最便于管理和维护的方式。Docker能将应用及其所有依赖打包在一个独立的容器中实现环境隔离、快速部署和一致运行。3.1 Docker引擎安装与优化在Ubuntu上安装Docker官方提供了便捷的脚本但我们更推荐使用APT仓库安装这样便于后续管理和升级。添加Docker官方GPG密钥和仓库# 卸载可能存在的旧版本 sudo apt remove docker docker-engine docker.io containerd runc # 安装依赖包 sudo apt install -y ca-certificates curl gnupg lsb-release # 添加Docker的官方GPG密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 设置稳定版仓库 echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null安装Docker引擎sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin权限配置与验证默认情况下运行Docker命令需要sudo。为了方便我们将当前用户加入docker组。sudo usermod -aG docker $USER重要执行此命令后你需要完全退出当前SSH会话并重新登录用户组变更才会生效。 重新登录后运行以下命令验证安装是否成功docker --version docker run hello-world如果能看到Docker版本信息以及“Hello from Docker!”的提示说明安装成功。Docker守护进程优化可选但推荐为了避免容器日志无限增长占满磁盘我们可以配置Docker的日志驱动和存储限制。编辑配置文件/etc/docker/daemon.json如果不存在则创建{ log-driver: json-file, log-opts: { max-size: 10m, max-file: 3 }, storage-driver: overlay2 }这里将每个容器的日志文件大小限制在10MB最多保留3个文件。修改后重启Docker服务sudo systemctl restart docker。3.2 Docker Compose部署解析虽然安装了docker-compose-plugin但为了编写清晰的结构化部署文件我们通常还是使用docker-compose.yml。通过Compose我们可以用一份YAML文件定义整个应用服务包括Uptime Kuma及其依赖的数据库管理起来极其方便。首先创建一个专门的工作目录mkdir -p ~/uptime-kuma cd ~/uptime-kuma然后创建docker-compose.yml文件version: 3.8 services: uptime-kuma: image: louislam/uptime-kuma:latest container_name: uptime-kuma restart: unless-stopped volumes: - ./uptime-kuma-data:/app/data ports: - 3001:3001 environment: - TZAsia/Shanghai # 如果你需要在一个容器内监控其他容器的健康状态可以取消下面的注释 # network_mode: host这个配置非常简洁但每一行都有其作用image: 指定使用的镜像louislam/uptime-kuma是官方镜像。container_name: 为容器指定一个名字便于管理。restart: unless-stopped: 确保容器在意外退出非手动停止时自动重启保证服务高可用。volumes: 这是数据持久化的关键。将容器内的/app/data目录存放所有配置、监控数据和SQLite数据库映射到宿主机的./uptime-kuma-data目录。这样即使容器被删除重建你的监控数据也不会丢失。ports: 将容器内的3001端口映射到宿主机的3001端口。之后我们通过http://你的LattePanda-IP:3001来访问Web界面。environment: 设置容器的时区确保通知和时间戳显示正确。network_mode: host注释状态默认情况下容器拥有独立的网络命名空间。如果你需要监控宿主机本身的服务如监听127.0.0.1或localhost的服务则需要使用host网络模式让容器共享宿主机的网络栈。但请注意这可能会带来一定的安全风险且端口映射ports配置在host模式下无效。对于绝大多数监控公网或局域网其他IP的服务默认的桥接模式就足够了此项保持注释。实操心得强烈建议在volumes映射中使用相对路径如./uptime-kuma-data而非绝对路径。这样你的整个项目Compose文件和数据目录都在一起备份、迁移或版本管理用git管理Compose文件会非常方便。只需打包这个目录放到另一台机器上执行docker-compose up -d就能瞬间恢复整个监控系统。4. Uptime Kuma的初始化与核心配置部署文件准备就绪后启动服务并进入核心的配置环节。4.1 服务启动与初次登录在docker-compose.yml所在目录执行以下命令启动服务docker-compose up -d-d参数代表“后台运行”。使用docker-compose logs -f uptime-kuma可以实时查看启动日志确认没有报错。服务启动后打开浏览器访问http://你的LattePanda IP地址:3001。例如http://192.168.1.200:3001。你将看到Uptime Kuma的初始化界面。首先你需要创建一个管理员账户。输入用户名、邮箱和密码。这个邮箱将用于接收通知如果你配置了邮件通知请务必填写真实可用的邮箱。登录后你就进入了Uptime Kuma的主仪表盘。界面干净直观但在此之前我们有必要进行一些基础设置。4.2 关键全局设置详解点击左上角菜单图标进入“Settings”设置。常规设置站点名称给你的监控面板起个名字比如“Home Lab Monitor”。语言选择简体中文。时区确保与之前Docker Compose中设置的TZ环境变量一致选择Asia/Shanghai。主题根据喜好选择浅色或深色模式。安全设置重要禁用注册在“安全”选项卡下找到“禁用注册”并开启。初始化完成后必须关闭公开注册否则任何人都可以来你的面板注册账号。信任代理如果你计划通过Nginx等反向代理访问Uptime Kuma并且希望日志中记录真实的客户端IP需要在这里配置。例如如果你的反向代理和Uptime Kuma在同一台机器或Docker网络内可以设置为loopback, 172.16.0.0/12Docker默认网段。备份定期备份在“备份”选项卡你可以手动下载一个.zip备份文件其中包含了所有监控配置和数据。我习惯每周手动备份一次并将备份文件同步到NAS或网盘。通知设置核心功能这是Uptime Kuma的“灵魂”。点击“通知”标签页点击“添加通知”。它支持数十种通知方式我挑选几个最实用的讲解电子邮件SMTP最传统但可靠的方式。你需要一个SMTP服务器信息如QQ邮箱、Gmail或你的企业邮箱。填写SMTP服务器地址、端口、加密方式SSL/TLS、发件邮箱和密码/授权码。添加后务必点击“测试”按钮确认能收到测试邮件。Telegram实时性极佳。你需要先与BotFather创建一个Bot获取Token。然后在Uptime Kuma中选择Telegram粘贴Token。它会产生一个链接点击链接与你的Bot对话后就能收到Chat ID并完成配置。钉钉DingTalk国内团队常用。在钉钉群添加“自定义机器人”获取Webhook地址粘贴进来即可。Webhook最灵活的方式。你可以将状态变更事件发送到任何能接收HTTP请求的服务比如触发智能家居的灯光报警、发送到企业微信、或者记录到日志系统。注意事项配置通知时建议至少设置两种不同渠道如“邮件Telegram”避免单一渠道失效导致告警遗漏。对于关键服务可以开启“启用心跳”功能定期测试通知渠道本身是否正常。5. 监控项配置实战与高级技巧配置好通知就可以开始添加你的监控项了。点击主界面大大的“添加监控”按钮。5.1 监控类型深度解析Uptime Kuma支持多种监控类型理解其原理和适用场景是关键HTTP(s)最常用监控网站或API的可用性。URL填写完整的地址如https://api.example.com/health。请求间隔默认60秒。对于核心服务可以缩短到30秒甚至20秒对于不重要服务可以延长到120秒以减轻目标服务器压力。超时时间默认30秒。如果目标服务器响应慢可以适当延长。高级选项关键词检查响应体是否包含特定关键词如“success”用于验证API功能是否正常而不仅仅是端口可通。不包含关键词检查响应体是否不包含特定关键词如“error”反向验证。请求头/请求体可以模拟登录、传递API密钥等用于监控需要认证的端点。代理如果你的LattePanda处于内网需要通过代理才能访问外网服务可以在此配置。TCP端口监控数据库如MySQL的3306端口、SSH22端口、游戏服务器等是否可连接。只需填写主机名或IP和端口号。Uptime Kuma会尝试建立TCP连接。PingICMP监控网络设备的在线状态如路由器、交换机、另一台电脑。重要前提Docker容器默认无法发送Ping包ICMP。要让Uptime Kuma支持Ping必须在启动容器时添加--cap-addNET_RAW能力。修改你的docker-compose.ymlservices: uptime-kuma: # ... 其他配置 ... cap_add: - NET_RAW修改后执行docker-compose down然后docker-compose up -d重启服务。DNS监控DNS解析是否正常以及解析结果是否正确。可以指定查询类型A, AAAA, CNAME等和期望的解析结果。Push被动监控由被监控的服务主动向Uptime Kuma“报到”。适用于无法从外部主动探测的服务比如你电脑上的一个本地应用。你需要在该应用中集成一个定时任务定期向Uptime Kuma提供的唯一URL发送HTTP请求类似于“心跳包”。5.2 分组、标签与状态页管理当监控项多起来后管理就成了问题。Uptime Kuma的分组和标签功能非常好用。分组你可以创建如“家庭服务”、“云服务器”、“工作项目”等分组。在添加或编辑监控项时可以将其分配到特定分组。在仪表盘上可以按组折叠/展开查看一目了然。标签比分组更灵活。一个监控项可以打上多个标签如#database、#critical、#external-api。然后你可以通过标签过滤器快速筛选出所有关键服务或所有数据库服务。创建公开状态页你或许不想让所有人都登录你的管理后台但希望有一个公开页面展示核心服务的状态就像很多公司的官方状态页一样。Uptime Kuma内置了这个功能。进入“设置” - “状态页”。点击“创建状态页”设置标题、描述、主题等。最关键的一步在“监控列表”中选择哪些监控项要显示在这个公开页面上。你可以选择整个分组或基于标签选择。保存后你会获得一个独立的访问链接如http://你的IP:3001/status/xxxx。这个页面是只读的美观且专业。6. 性能调优、维护与故障排查部署完成并运行一段时间后我们需要关注系统的长期稳定性和性能。6.1 LattePanda资源监控与优化虽然Uptime Kuma本身很轻量但长期运行仍需关注资源使用情况。查看容器资源占用docker stats uptime-kuma这个命令会实时显示容器的CPU、内存使用率、网络IO和块设备IO。正常情况下Uptime Kuma容器内存占用应在100-300MB之间CPU使用率极低。监控宿主机状态使用之前安装的htop可以全面了解LattePanda的整体负载。关注点内存确保有足够的可用内存。如果SWAP被频繁使用说明物理内存不足。CPU温度LattePanda 3 Delta的散热能力尚可但长期高负载或在密闭空间运行仍需注意。可以安装lm-sensors来查看温度sudo apt install lm-sensors sensors。磁盘空间定期检查数据卷的磁盘使用情况特别是如果你监控了大量服务并保留了长期历史记录。df -h ~/uptime-kuma/uptime-kuma-data/日志管理Uptime Kuma的日志默认输出到容器控制台我们通过Docker Compose的日志驱动进行了限制。查看日志docker-compose logs --tail 50 uptime-kuma # 查看最近50行 docker-compose logs -f uptime-kuma # 实时跟踪日志如果发现日志增长过快可以进入容器内检查/app/data/logs目录或者回顾Docker守护进程的日志配置。6.2 常见问题与排查实录即使配置无误在实际运行中也可能遇到问题。以下是我踩过的一些坑和解决方案问题1无法访问Web界面http://IP:3001打不开排查步骤检查容器状态docker-compose ps。确保状态是Up。检查端口占用sudo netstat -tlnp | grep :3001。看是否是3001端口被其他程序占用。如果是修改docker-compose.yml中的端口映射例如改为3002:3001。检查防火墙LattePanda上的UFW防火墙可能阻止了端口。放行端口sudo ufw allow 3001/tcp。检查网络确保你访问的客户端和LattePanda在同一个局域网网段。问题2监控HTTP服务一直显示“Down”但实际服务是好的排查步骤检查URL和端口确保没有拼写错误。从容器的角度测试进入Uptime Kuma容器内部用curl命令测试。docker exec -it uptime-kuma /bin/sh apk add curl # 如果容器内没有curl先安装这是Alpine镜像 curl -v http://你要监控的目标地址:端口这样可以判断是网络连通性问题还是Uptime Kuma配置问题。检查高级选项是否设置了“关键词”或“不包含关键词”但条件不匹配是否启用了代理但代理不可用问题3通知收不到排查步骤测试通知渠道在“通知”设置里对已配置的渠道点击“测试”。这是最直接的验证方法。检查SMTP/Webhook配置仔细核对服务器地址、端口、加密方式、用户名/密码、Token、Webhook URL等。一个字符错误都会导致失败。查看容器日志docker-compose logs uptime-kuma | grep -i notification\|email\|telegram。日志中通常会记录发送通知的成功或失败信息。问题4数据丢失或面板重置原因与预防这几乎100%是因为没有正确配置数据卷持久化或者误删了宿主机上的数据目录。解决方案立即停止容器docker-compose down。检查~/uptime-kuma/uptime-kuma-data目录是否存在且是否有内容特别是kuma.db数据库文件。如果数据目录存在重新docker-compose up -d即可恢复。教训务必确保docker-compose.yml中的volumes映射配置正确并定期备份这个数据目录。6.3 备份、迁移与升级备份最简单的备份就是复制整个~/uptime-kuma目录。更优雅的方式是使用tar打包cd ~ tar -czf uptime-kuma-backup-$(date %Y%m%d).tar.gz uptime-kuma/可以将这个压缩包存到NAS、云存储或其他安全的地方。迁移在新机器上安装好Docker和Docker Compose将备份的整个uptime-kuma目录传过去直接运行docker-compose up -d服务就会原样启动。升级Uptime Kuma的升级非常简单因为所有数据都在宿主机目录里。停止当前容器docker-compose down。拉取最新镜像docker-compose pull。重新启动docker-compose up -d。 升级前强烈建议先进行备份。7. 扩展应用将监控集成到智能家居与告警升级当基础监控稳定运行后我们可以玩点更花的让它更好地融入我们的数字生活。与Home Assistant联动如果你也使用Home Assistant管理智能家居可以将Uptime Kuma的告警集成进去。例如当核心NAS服务宕机时不仅发送通知还可以让家里的某个智能灯闪烁红光。在Uptime Kuma中为关键监控项配置Webhook通知。在Home Assistant中创建一个自动化Automation触发器Trigger类型选择“Webhook”。将Uptime Kuma的Webhook地址指向Home Assistant提供的Webhook URL。在自动化中解析Webhook传递的JSON数据包含服务名、状态等并执行控制灯光的动作。搭建多节点监控Uptime Kuma支持“心跳Heartbeat”监控。你可以在另一台位于不同网络的服务器比如一台轻量云服务器上也部署一个Uptime Kuma并配置它向你的主LattePanda节点发送心跳。这样如果主节点本身宕机云服务器上的备用节点会因为收不到心跳而发出告警实现了对监控系统自身的“反查”。配置告警升级Escalation对于极其关键的服务可以设置分级告警。例如服务下线1分钟后发送Telegram通知给个人如果5分钟后仍未恢复则额外发送邮件通知到整个运维团队邮件组10分钟后仍未恢复则触发电话告警可通过集成Twilio等语音呼叫API实现。虽然Uptime Kuma原生不支持复杂的告警升级规则但可以通过其Webhook触发外部脚本或集成自动化平台如n8n, Zapier来实现。最后关于这个LattePanda Uptime Kuma的组合我实际跑了小半年稳定性完全超出预期。它安静地待在角落几乎忘了它的存在直到某天深夜Telegram突然弹出“API Gateway Down”的告警才让人想起这位忠实的哨兵。这种“平时无感用时救命”的工具才是家庭实验室里最值得投入的基建。如果你也有一台闲置的小主机不妨试试这个方案它带来的掌控感和安心感远比想象中要大。 在LattePanda上部署Uptime Kuma：打造低功耗自托管监控面板
1. 项目概述为什么要在LattePanda上部署Uptime Kuma最近在折腾我的家庭监控面板手头正好有一台闲置的LattePanda 3 Delta。这玩意儿性能不错功耗也低一直想给它找个正经活儿干。之前用它跑过一些轻量服务但总觉得有点大材小用。直到我开始为家里和工作室的十几个服务从NAS、智能家居网关到自建的各种API的在线状态发愁时才想起来Uptime Kuma这个开源监控神器。Uptime Kuma是什么简单说它就是一个自托管的、颜值在线的服务状态监控面板。你可以把它理解为你所有网络服务的“健康仪表盘”。哪个网站打不开了哪个API响应慢了它都能第一时间通过邮件、钉钉、Telegram等一大堆渠道通知你而且所有监控历史和状态都一目了然地展示在一个漂亮的Web页面上。最关键的是它完全免费、开源数据掌握在自己手里不用担心服务商的限制或隐私问题。那么为什么偏偏要选LattePanda 3 Delta这台小主机来跑它呢这里有几个很实际的考虑。首先24小时低功耗运行是刚需。LattePanda 3 Delta的整机功耗通常在10-20瓦之间比一台常年开机的台式机或笔记本省电得多非常适合作为家庭实验室的“基础设施”主机。其次性能足够且有盈余。它搭载的Intel Celeron N5105处理器和8GB内存运行一个Docker容器化的Uptime Kuma绰绰有余甚至还能同时跑点别的轻量服务。最后物理部署灵活。这台小主板尺寸迷你可以轻松塞进弱电箱、电视柜后面或者用3D打印个外壳挂在墙上不占地方也没有风扇噪音的困扰。这个组合本质上是在打造一个完全自主可控、低成本、高可用的核心网络监控节点。它不再只是一个玩具项目而是能真正融入日常运维成为你数字生活里一个安静而可靠的“守望者”。2. 环境准备与系统选型在LattePanda上部署任何服务第一步也是最重要的一步就是打好系统基础。一个稳定、高效且易于维护的操作系统是后续所有操作顺利进行的保障。2.1 操作系统选择与考量为LattePanda这类x86架构的迷你主机选择系统我们有几个主流方向Windows、Ubuntu Server、Debian或者一些轻量级发行版。经过反复实测我强烈推荐Ubuntu Server 22.04 LTS。理由如下长期支持与稳定性LTS版本提供5年的安全更新和维护避免了频繁升级带来的潜在风险这对于需要7x24小时运行的监控服务至关重要。资源占用与性能Ubuntu Server没有图形界面系统开销极小。安装完成后空闲内存占用通常在500MB以下为Uptime Kuma和其他服务留出了充足的空间。社区与生态拥有最庞大的用户社区和文档支持。无论是遇到驱动问题、网络配置还是Docker安装你几乎都能找到现成的解决方案和讨论。对LattePanda的兼容性Ubuntu的内核对新硬件的支持很好。LattePanda 3 Delta的网卡、声卡、GPIO等组件在Ubuntu 22.04上基本可以开箱即用省去了折腾驱动的麻烦。当然如果你对系统洁癖有更高要求Debian也是极好的选择它在稳定性上更胜一筹但可能需要在驱动和软件包版本上多花一点心思。Windows则不太推荐其后台服务较多资源占用高且对于运行Docker容器不如Linux原生高效和方便。2.2 系统安装与基础配置将Ubuntu Server镜像写入U盘后启动LattePanda并从U盘引导安装。安装过程有几个关键点需要注意分区方案对于监控主机我建议采用手动分区。创建一个单独的/var分区是个好习惯因为Docker的镜像、容器以及Uptime Kuma的数据库默认都存放在这里。给/var分配20-30GB的空间可以避免日后因日志或镜像积累导致根目录爆满。剩下的空间可以挂载到/home或一个专门的数据目录。用户设置务必创建一个具有sudo权限的普通用户例如monitor并禁用root用户的SSH登录。这是最基本的安全加固步骤。网络配置建议在安装时就配置好静态IP地址。因为这台设备将作为监控节点一个固定的IP地址便于我们通过浏览器访问其Web界面也方便在其他设备上配置指向它的DNS或反向代理。记下你为它设置的IP比如192.168.1.200。软件选择在安装类型界面只勾选“OpenSSH server”即可。其他服务我们后续按需安装保持系统纯净。系统安装完成后首先进行更新和基础工具安装sudo apt update sudo apt upgrade -y sudo apt install -y curl wget vim git htop net-toolshtop可以让你直观地查看CPU、内存和进程状态net-tools包含了ifconfig等老牌网络工具在排查问题时很有用。注意首次SSH登录后建议立即修改SSH默认端口如改为2222并配置密钥认证彻底关闭密码登录。这是将设备暴露在家庭网络中的一项重要安全措施。具体操作可以通过编辑/etc/ssh/sshd_config文件实现。3. 核心依赖部署Docker与Docker ComposeUptime Kuma官方推荐使用Docker进行部署这是目前最主流、最便于管理和维护的方式。Docker能将应用及其所有依赖打包在一个独立的容器中实现环境隔离、快速部署和一致运行。3.1 Docker引擎安装与优化在Ubuntu上安装Docker官方提供了便捷的脚本但我们更推荐使用APT仓库安装这样便于后续管理和升级。添加Docker官方GPG密钥和仓库# 卸载可能存在的旧版本 sudo apt remove docker docker-engine docker.io containerd runc # 安装依赖包 sudo apt install -y ca-certificates curl gnupg lsb-release # 添加Docker的官方GPG密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 设置稳定版仓库 echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null安装Docker引擎sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin权限配置与验证默认情况下运行Docker命令需要sudo。为了方便我们将当前用户加入docker组。sudo usermod -aG docker $USER重要执行此命令后你需要完全退出当前SSH会话并重新登录用户组变更才会生效。 重新登录后运行以下命令验证安装是否成功docker --version docker run hello-world如果能看到Docker版本信息以及“Hello from Docker!”的提示说明安装成功。Docker守护进程优化可选但推荐为了避免容器日志无限增长占满磁盘我们可以配置Docker的日志驱动和存储限制。编辑配置文件/etc/docker/daemon.json如果不存在则创建{ log-driver: json-file, log-opts: { max-size: 10m, max-file: 3 }, storage-driver: overlay2 }这里将每个容器的日志文件大小限制在10MB最多保留3个文件。修改后重启Docker服务sudo systemctl restart docker。3.2 Docker Compose部署解析虽然安装了docker-compose-plugin但为了编写清晰的结构化部署文件我们通常还是使用docker-compose.yml。通过Compose我们可以用一份YAML文件定义整个应用服务包括Uptime Kuma及其依赖的数据库管理起来极其方便。首先创建一个专门的工作目录mkdir -p ~/uptime-kuma cd ~/uptime-kuma然后创建docker-compose.yml文件version: 3.8 services: uptime-kuma: image: louislam/uptime-kuma:latest container_name: uptime-kuma restart: unless-stopped volumes: - ./uptime-kuma-data:/app/data ports: - 3001:3001 environment: - TZAsia/Shanghai # 如果你需要在一个容器内监控其他容器的健康状态可以取消下面的注释 # network_mode: host这个配置非常简洁但每一行都有其作用image: 指定使用的镜像louislam/uptime-kuma是官方镜像。container_name: 为容器指定一个名字便于管理。restart: unless-stopped: 确保容器在意外退出非手动停止时自动重启保证服务高可用。volumes: 这是数据持久化的关键。将容器内的/app/data目录存放所有配置、监控数据和SQLite数据库映射到宿主机的./uptime-kuma-data目录。这样即使容器被删除重建你的监控数据也不会丢失。ports: 将容器内的3001端口映射到宿主机的3001端口。之后我们通过http://你的LattePanda-IP:3001来访问Web界面。environment: 设置容器的时区确保通知和时间戳显示正确。network_mode: host注释状态默认情况下容器拥有独立的网络命名空间。如果你需要监控宿主机本身的服务如监听127.0.0.1或localhost的服务则需要使用host网络模式让容器共享宿主机的网络栈。但请注意这可能会带来一定的安全风险且端口映射ports配置在host模式下无效。对于绝大多数监控公网或局域网其他IP的服务默认的桥接模式就足够了此项保持注释。实操心得强烈建议在volumes映射中使用相对路径如./uptime-kuma-data而非绝对路径。这样你的整个项目Compose文件和数据目录都在一起备份、迁移或版本管理用git管理Compose文件会非常方便。只需打包这个目录放到另一台机器上执行docker-compose up -d就能瞬间恢复整个监控系统。4. Uptime Kuma的初始化与核心配置部署文件准备就绪后启动服务并进入核心的配置环节。4.1 服务启动与初次登录在docker-compose.yml所在目录执行以下命令启动服务docker-compose up -d-d参数代表“后台运行”。使用docker-compose logs -f uptime-kuma可以实时查看启动日志确认没有报错。服务启动后打开浏览器访问http://你的LattePanda IP地址:3001。例如http://192.168.1.200:3001。你将看到Uptime Kuma的初始化界面。首先你需要创建一个管理员账户。输入用户名、邮箱和密码。这个邮箱将用于接收通知如果你配置了邮件通知请务必填写真实可用的邮箱。登录后你就进入了Uptime Kuma的主仪表盘。界面干净直观但在此之前我们有必要进行一些基础设置。4.2 关键全局设置详解点击左上角菜单图标进入“Settings”设置。常规设置站点名称给你的监控面板起个名字比如“Home Lab Monitor”。语言选择简体中文。时区确保与之前Docker Compose中设置的TZ环境变量一致选择Asia/Shanghai。主题根据喜好选择浅色或深色模式。安全设置重要禁用注册在“安全”选项卡下找到“禁用注册”并开启。初始化完成后必须关闭公开注册否则任何人都可以来你的面板注册账号。信任代理如果你计划通过Nginx等反向代理访问Uptime Kuma并且希望日志中记录真实的客户端IP需要在这里配置。例如如果你的反向代理和Uptime Kuma在同一台机器或Docker网络内可以设置为loopback, 172.16.0.0/12Docker默认网段。备份定期备份在“备份”选项卡你可以手动下载一个.zip备份文件其中包含了所有监控配置和数据。我习惯每周手动备份一次并将备份文件同步到NAS或网盘。通知设置核心功能这是Uptime Kuma的“灵魂”。点击“通知”标签页点击“添加通知”。它支持数十种通知方式我挑选几个最实用的讲解电子邮件SMTP最传统但可靠的方式。你需要一个SMTP服务器信息如QQ邮箱、Gmail或你的企业邮箱。填写SMTP服务器地址、端口、加密方式SSL/TLS、发件邮箱和密码/授权码。添加后务必点击“测试”按钮确认能收到测试邮件。Telegram实时性极佳。你需要先与BotFather创建一个Bot获取Token。然后在Uptime Kuma中选择Telegram粘贴Token。它会产生一个链接点击链接与你的Bot对话后就能收到Chat ID并完成配置。钉钉DingTalk国内团队常用。在钉钉群添加“自定义机器人”获取Webhook地址粘贴进来即可。Webhook最灵活的方式。你可以将状态变更事件发送到任何能接收HTTP请求的服务比如触发智能家居的灯光报警、发送到企业微信、或者记录到日志系统。注意事项配置通知时建议至少设置两种不同渠道如“邮件Telegram”避免单一渠道失效导致告警遗漏。对于关键服务可以开启“启用心跳”功能定期测试通知渠道本身是否正常。5. 监控项配置实战与高级技巧配置好通知就可以开始添加你的监控项了。点击主界面大大的“添加监控”按钮。5.1 监控类型深度解析Uptime Kuma支持多种监控类型理解其原理和适用场景是关键HTTP(s)最常用监控网站或API的可用性。URL填写完整的地址如https://api.example.com/health。请求间隔默认60秒。对于核心服务可以缩短到30秒甚至20秒对于不重要服务可以延长到120秒以减轻目标服务器压力。超时时间默认30秒。如果目标服务器响应慢可以适当延长。高级选项关键词检查响应体是否包含特定关键词如“success”用于验证API功能是否正常而不仅仅是端口可通。不包含关键词检查响应体是否不包含特定关键词如“error”反向验证。请求头/请求体可以模拟登录、传递API密钥等用于监控需要认证的端点。代理如果你的LattePanda处于内网需要通过代理才能访问外网服务可以在此配置。TCP端口监控数据库如MySQL的3306端口、SSH22端口、游戏服务器等是否可连接。只需填写主机名或IP和端口号。Uptime Kuma会尝试建立TCP连接。PingICMP监控网络设备的在线状态如路由器、交换机、另一台电脑。重要前提Docker容器默认无法发送Ping包ICMP。要让Uptime Kuma支持Ping必须在启动容器时添加--cap-addNET_RAW能力。修改你的docker-compose.ymlservices: uptime-kuma: # ... 其他配置 ... cap_add: - NET_RAW修改后执行docker-compose down然后docker-compose up -d重启服务。DNS监控DNS解析是否正常以及解析结果是否正确。可以指定查询类型A, AAAA, CNAME等和期望的解析结果。Push被动监控由被监控的服务主动向Uptime Kuma“报到”。适用于无法从外部主动探测的服务比如你电脑上的一个本地应用。你需要在该应用中集成一个定时任务定期向Uptime Kuma提供的唯一URL发送HTTP请求类似于“心跳包”。5.2 分组、标签与状态页管理当监控项多起来后管理就成了问题。Uptime Kuma的分组和标签功能非常好用。分组你可以创建如“家庭服务”、“云服务器”、“工作项目”等分组。在添加或编辑监控项时可以将其分配到特定分组。在仪表盘上可以按组折叠/展开查看一目了然。标签比分组更灵活。一个监控项可以打上多个标签如#database、#critical、#external-api。然后你可以通过标签过滤器快速筛选出所有关键服务或所有数据库服务。创建公开状态页你或许不想让所有人都登录你的管理后台但希望有一个公开页面展示核心服务的状态就像很多公司的官方状态页一样。Uptime Kuma内置了这个功能。进入“设置” - “状态页”。点击“创建状态页”设置标题、描述、主题等。最关键的一步在“监控列表”中选择哪些监控项要显示在这个公开页面上。你可以选择整个分组或基于标签选择。保存后你会获得一个独立的访问链接如http://你的IP:3001/status/xxxx。这个页面是只读的美观且专业。6. 性能调优、维护与故障排查部署完成并运行一段时间后我们需要关注系统的长期稳定性和性能。6.1 LattePanda资源监控与优化虽然Uptime Kuma本身很轻量但长期运行仍需关注资源使用情况。查看容器资源占用docker stats uptime-kuma这个命令会实时显示容器的CPU、内存使用率、网络IO和块设备IO。正常情况下Uptime Kuma容器内存占用应在100-300MB之间CPU使用率极低。监控宿主机状态使用之前安装的htop可以全面了解LattePanda的整体负载。关注点内存确保有足够的可用内存。如果SWAP被频繁使用说明物理内存不足。CPU温度LattePanda 3 Delta的散热能力尚可但长期高负载或在密闭空间运行仍需注意。可以安装lm-sensors来查看温度sudo apt install lm-sensors sensors。磁盘空间定期检查数据卷的磁盘使用情况特别是如果你监控了大量服务并保留了长期历史记录。df -h ~/uptime-kuma/uptime-kuma-data/日志管理Uptime Kuma的日志默认输出到容器控制台我们通过Docker Compose的日志驱动进行了限制。查看日志docker-compose logs --tail 50 uptime-kuma # 查看最近50行 docker-compose logs -f uptime-kuma # 实时跟踪日志如果发现日志增长过快可以进入容器内检查/app/data/logs目录或者回顾Docker守护进程的日志配置。6.2 常见问题与排查实录即使配置无误在实际运行中也可能遇到问题。以下是我踩过的一些坑和解决方案问题1无法访问Web界面http://IP:3001打不开排查步骤检查容器状态docker-compose ps。确保状态是Up。检查端口占用sudo netstat -tlnp | grep :3001。看是否是3001端口被其他程序占用。如果是修改docker-compose.yml中的端口映射例如改为3002:3001。检查防火墙LattePanda上的UFW防火墙可能阻止了端口。放行端口sudo ufw allow 3001/tcp。检查网络确保你访问的客户端和LattePanda在同一个局域网网段。问题2监控HTTP服务一直显示“Down”但实际服务是好的排查步骤检查URL和端口确保没有拼写错误。从容器的角度测试进入Uptime Kuma容器内部用curl命令测试。docker exec -it uptime-kuma /bin/sh apk add curl # 如果容器内没有curl先安装这是Alpine镜像 curl -v http://你要监控的目标地址:端口这样可以判断是网络连通性问题还是Uptime Kuma配置问题。检查高级选项是否设置了“关键词”或“不包含关键词”但条件不匹配是否启用了代理但代理不可用问题3通知收不到排查步骤测试通知渠道在“通知”设置里对已配置的渠道点击“测试”。这是最直接的验证方法。检查SMTP/Webhook配置仔细核对服务器地址、端口、加密方式、用户名/密码、Token、Webhook URL等。一个字符错误都会导致失败。查看容器日志docker-compose logs uptime-kuma | grep -i notification\|email\|telegram。日志中通常会记录发送通知的成功或失败信息。问题4数据丢失或面板重置原因与预防这几乎100%是因为没有正确配置数据卷持久化或者误删了宿主机上的数据目录。解决方案立即停止容器docker-compose down。检查~/uptime-kuma/uptime-kuma-data目录是否存在且是否有内容特别是kuma.db数据库文件。如果数据目录存在重新docker-compose up -d即可恢复。教训务必确保docker-compose.yml中的volumes映射配置正确并定期备份这个数据目录。6.3 备份、迁移与升级备份最简单的备份就是复制整个~/uptime-kuma目录。更优雅的方式是使用tar打包cd ~ tar -czf uptime-kuma-backup-$(date %Y%m%d).tar.gz uptime-kuma/可以将这个压缩包存到NAS、云存储或其他安全的地方。迁移在新机器上安装好Docker和Docker Compose将备份的整个uptime-kuma目录传过去直接运行docker-compose up -d服务就会原样启动。升级Uptime Kuma的升级非常简单因为所有数据都在宿主机目录里。停止当前容器docker-compose down。拉取最新镜像docker-compose pull。重新启动docker-compose up -d。 升级前强烈建议先进行备份。7. 扩展应用将监控集成到智能家居与告警升级当基础监控稳定运行后我们可以玩点更花的让它更好地融入我们的数字生活。与Home Assistant联动如果你也使用Home Assistant管理智能家居可以将Uptime Kuma的告警集成进去。例如当核心NAS服务宕机时不仅发送通知还可以让家里的某个智能灯闪烁红光。在Uptime Kuma中为关键监控项配置Webhook通知。在Home Assistant中创建一个自动化Automation触发器Trigger类型选择“Webhook”。将Uptime Kuma的Webhook地址指向Home Assistant提供的Webhook URL。在自动化中解析Webhook传递的JSON数据包含服务名、状态等并执行控制灯光的动作。搭建多节点监控Uptime Kuma支持“心跳Heartbeat”监控。你可以在另一台位于不同网络的服务器比如一台轻量云服务器上也部署一个Uptime Kuma并配置它向你的主LattePanda节点发送心跳。这样如果主节点本身宕机云服务器上的备用节点会因为收不到心跳而发出告警实现了对监控系统自身的“反查”。配置告警升级Escalation对于极其关键的服务可以设置分级告警。例如服务下线1分钟后发送Telegram通知给个人如果5分钟后仍未恢复则额外发送邮件通知到整个运维团队邮件组10分钟后仍未恢复则触发电话告警可通过集成Twilio等语音呼叫API实现。虽然Uptime Kuma原生不支持复杂的告警升级规则但可以通过其Webhook触发外部脚本或集成自动化平台如n8n, Zapier来实现。最后关于这个LattePanda Uptime Kuma的组合我实际跑了小半年稳定性完全超出预期。它安静地待在角落几乎忘了它的存在直到某天深夜Telegram突然弹出“API Gateway Down”的告警才让人想起这位忠实的哨兵。这种“平时无感用时救命”的工具才是家庭实验室里最值得投入的基建。如果你也有一台闲置的小主机不妨试试这个方案它带来的掌控感和安心感远比想象中要大。