快速开始
本页介绍如何以最快方式将 VOMS 部署到一台 Linux 服务器上。
环境要求
- 操作系统：Ubuntu 22.04+（或其他主流 Linux 发行版）
- 权限：root 或 sudo
- 资源：建议 4C8G 起步
- 网络：服务器可访问外网（安装系统依赖时需要）
一键部署
在服务器上执行以下命令，自动下载发布包并启动 Web 部署向导：
bash
curl -sSL https://voms.install.iluwen.cn/install.sh | sudo bash指定版本
bash
VOMS_VERSION=v1.0.0 curl -sSL https://voms.install.iluwen.cn/install.sh | sudo bash脚本会自动检测系统架构（amd64/arm64），下载对应发布包到 /opt/voms-release，然后启动部署向导。
手动部署（离线环境）
从发布渠道下载发布包并解压到服务器：
bash
cd /opt/voms-release
sudo ./voms-deploy发布包目录应至少包含：
voms-deploy
bin/server
bin/worker-consumer
bin/worker-scheduler
frontend/
migrations/up/*.sql
configs/casbin/model.conf在仓库根目录执行 make package-release 可自动生成发布包。
Web 向导流程
程序启动后会在终端打印浏览器访问地址，打开浏览器完成向导：
- 环境检测 — 自动检测系统环境
- 依赖安装 — 选择并安装 PostgreSQL / Valkey / NATS / Caddy
- 参数配置 — 数据库、JWT、管理员账号、前端地址、端口 + 连接测试
- 确认部署 — 预览配置并确认
- 自动部署 — 复制二进制、执行数据库迁移、生成配置、创建 systemd 服务、配置 Caddy
- 健康检查 — 自动验证并显示管理员凭据
验证部署
bash
# 后端健康检查
curl -s http://localhost:8181/api/v1/public/system/health | jq .
# 服务状态
systemctl status voms-server --no-pager
systemctl status voms-worker-consumer --no-pager
systemctl status voms-worker-scheduler --no-pager预期输出：所有服务 active (running)，健康接口返回正常状态。
部署产物
部署完成后自动生成：
| 文件 | 说明 |
|---|---|
/opt/voms/configs/config.production.json | 生产配置 |
/etc/systemd/system/voms-server.service | API 服务 |
/etc/systemd/system/voms-worker-consumer.service | 消费者 Worker |
/etc/systemd/system/voms-worker-scheduler.service | 调度器 Worker |
/var/www/voms/admin | 后台前端静态目录 |
/var/www/voms/public | 公众前端静态目录 |
/etc/caddy/Caddyfile | Caddy 站点配置（/api/* 反代后端） |