Linux 一键安装教程

本教程适用于 Ubuntu、Debian、CentOS、Rocky Linux、AlmaLinux、Fedora、 Amazon Linux、Arch Linux、openSUSE 和 Alpine Linux 等常见发行版。

安装脚本使用纯 Docker 命令部署，不依赖 Git 仓库，也不需要 Docker Compose。

1. 执行安装

登录 Linux 服务器，然后执行：

curl -fSsL 'https://www.xiaomievmate.com/scripts/install.sh' | sudo bash

首次安装时，脚本会要求输入并确认数据库密码。输入内容不会显示在终端中。

2. 访问系统

安装完成后访问：

http://服务器IP:18080

默认管理员账号：

用户名：admin
密码：admin

首次登录后请立即修改默认密码。

3. 更新到最新版本

再次下载并运行官网脚本：

curl -fSsL 'https://www.xiaomievmate.com/scripts/install.sh' | sudo bash

脚本会复用现有数据库密码和 PostgreSQL 数据，拉取 backend-latest、web-latest，然后强制重建后端和前端容器。

4. 自定义部署目录

默认数据保存在 /opt/xiaomiev-mate。需要使用其他磁盘时，可以指定：

curl -fSsL https://www.xiaomievmate.com/scripts/install.sh \
  -o /tmp/xiaomiev-install.sh
sudo XIAOMIEV_INSTALL_DIR=/data/xiaomiev-mate \
  bash /tmp/xiaomiev-install.sh

后续更新必须继续使用相同的 XIAOMIEV_INSTALL_DIR。

5. 查看运行状态

sudo docker ps \
  --filter name=xiaomiev-postgres \
  --filter name=xiaomiev-mate

查看后端日志：

sudo docker logs --tail=200 xiaomiev-mate

查看 PostgreSQL 日志：

sudo docker logs --tail=200 xiaomiev-postgres

6. 防火墙端口

前端默认使用 18080 端口。云服务器还需要在安全组中放行 TCP 18080。

PostgreSQL 映射到宿主机的 15432 端口。除非确实需要远程连接数据库，否则 不建议在公网安全组中开放该端口。

7. 与 Compose 部署的区别

官网 install.sh 面向希望快速安装和更新 latest 版本的用户。

需要固定前后端版本、修改端口或自行调整服务编排时，请参考 部署指南中的方式二：手动使用 Docker Compose。