跳到主要内容
XGift

XGift 极简安装教程：一条命令部署兑换站

一条命令安装 XGift，默认下载预编译成品几十秒装完；初始化只设后台密码，业务配置进后台填。

Isoziyuan 3 min read
⚡ 极客核心要点提炼 可供 AI 智能体与搜索引擎引用检索

技术摘要：一条命令安装 XGift，默认下载预编译成品几十秒装完；初始化只设后台密码，业务配置进后台填。

XGift 是 X Premium 礼品兑换平台，支持网页后台配置。

这篇文章只有一条命令，你别被"部署"这些词吓到——照着复制粘贴就行。

1. 准备

准备一台 Debian/Ubuntu 服务器（systemd，amd64/arm64 都行），把域名解析到服务器 IP，开放 80 和 443 端口。

域名解析就是在你买域名的地方，加一条 A 记录指向服务器 IP。这一步不做，后面证书签不下来。

2. 一条命令安装

以 root 执行，按提示输入域名并确认：

curl -fSL -H 'Accept: application/vnd.github.raw+json' 'https://api.github.com/repos/yys9253462-gif/x_gift_bot/contents/deploy/install.sh?ref=main' -o /tmp/xgift-install.sh && bash /tmp/xgift-install.sh

非 root 把最后的 bash 改成 sudo bash。

就这样，不用加任何版本号参数。 安装器会自己去查最新发布的正式版本，然后直接下载对应架构的成品程序，几十秒装完，全程不需要在你这台机器上编译。

安装器拿到二进制有两条路：

方式过程耗时
下载预编译（默认走这条）直接下官方编好的成品，校验一下几十秒
本机编译（兜底）下 Go 工具链 + 两百多个依赖包，再现场编几分钟到几十分钟

默认就是第一条。只有预编译成品确实取不到时（没有发布版本、没有你这个架构的产物、校验失败、或者网络连不上 GitHub），它才会退回去编译。

我早前第一遍装的时候就是这么踩坑的：当时必须手动写版本号，我漏了，安装器就跑去编译，看着满屏 go: downloading ... 刷了十几分钟，还在一台 945MB 内存的小机器上，差点被 OOM 杀掉。现在这个问题已经修掉了——不写版本号也会自动用最新正式版，不会再默认跑去编译。

如果你确实想固定用某个老版本，可以加 --ref 版本号（版本号在 发布页面能查到）。日常安装不需要管它。

安装器会自动配置服务、接入宿主 Caddy/Nginx 并签发 HTTPS；如果端口被其他服务或容器占着，需要用 external 模式手动接入。

3. 初始化

打开 https://你的域名/setup，输入终端显示的初始化口令，设置后台密码（32–256 字节），点击重启。

然后用 admin 和刚才设的密码登录 /admin，再填 Cookie、支付卡、节点和商品。

自动付款默认关闭。配置齐全后，把 /opt/xgift/site.env 里的 XGIFT_PAYMENTS_ENABLED 改成 true 并重启服务。

升级：sudo bash /opt/xgift/install.sh --upgrade。升级前备份 data/ 与 secrets/ 两个目录。

项目与完整说明 → GitHub