• Date: 2025-07-03

用 vince 可执行文件部署服务

项目地址

github

⸻

✅ 一、创建管理员账户（首次运行）

cd /home
chmod +x vince  # 确保可执行权限

./vince admin --name admin --password Ben@Ben.com

⸻

✅ 二、运行 Vince 服务

快速测试方式：

./vince serve

默认： - 服务监听在 http://localhost:8080 - 数据将保存在当前目录 /home/vince-data/ - 自动生成 TLS（如果使用域名，必须开放 443 端口）

你可以在浏览器访问：

http://你的公网IP:8080

例如：

http://101.132.248.137:8080

⸻

✅ 三、推荐部署方式：systemd 后台服务

下面是推荐的 systemd 部署方式，适合持续运行：

  1. 创建系统服务文件
sudo nano /etc/systemd/system/vince.service

填入以下内容（替换密码）：

[Unit]
Description=Vince Analytics Service
After=network.target

[Service]
ExecStart=/home/vince serve --adminName admin --adminPassword Ben@Ben.com
WorkingDirectory=/home
Restart=always
User=root
Environment=PORT=8080

[Install]
WantedBy=multi-user.target

保存并退出。

  1. 启动服务并设置开机自启
sudo systemctl daemon-reload
sudo systemctl enable vince
sudo systemctl start vince
  1. 查看运行状态
sudo systemctl status vince

⸻

✅ 四、可选：使用 Nginx 做反向代理

你可以让公网访问 http://yourdomain.com 映射到 localhost:8080：

sudo apt install nginx

编辑配置文件：

sudo nano /etc/nginx/sites-available/vince

添加如下内容：

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

启用并重启 nginx：

sudo ln -s /etc/nginx/sites-available/vince /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

⸻

✅ 五、查看数据目录和备份

默认的数据和日志会写入：

/home/vince-data/

建议你将它定期备份或同步到 OSS。

⸻

推荐你在首次用命令创建管理员之后，以后启动时省略密码参数，这样不会泄露敏感信息：

./vince admin --name admin --password "MySecure!Pass123"   # 只执行一次创建账户

之后就可以使用更简洁的启动命令:

ExecStart=/home/vince serve --port 8080

测试服务是否运行:

sudo systemctl status vince

目录