EPusdt v1.0.3 宝塔 / aaPanel 全新部署教程
视频教程
点击即可弹出播放
一、准备条件
- 一台 Linux 服务器，已安装宝塔 / aaPanel
- 面板里已安装
Nginx和Supervisor - 一个已经解析到服务器的域名，例如
pay.example.com - 服务器已放行
80和443端口
二、创建站点
- 进入宝塔 / aaPanel 面板，打开「网站」
- 新增站点，域名填写你的正式域名
- 站点目录填
/www/wwwroot/epusdt - PHP 版本选「纯静态」即可
这一步主要是让宝塔 / aaPanel 帮你管理域名、SSL 和 Nginx 反向代理。
三、下载并解压官方 v1.0.3 发布包
先确认服务器架构：
uname -m
x86_64下载 Linux amd64 包aarch64下载 Linux arm64 包
官方发布页：
https://github.com/GMWalletApp/epusdt/releases/tag/v1.0.3
把对应压缩包上传到 /www/wwwroot/epusdt 后直接解压。当前 v1.0.3 官方发布包解压后，目录里通常只有：
epusdt可执行文件.env.example配置样例
解压后先执行：
chmod 755 /www/wwwroot/epusdt/epusdt chown -R www:www /www/wwwroot/epusdt
如果你是用 root 解压，而 Supervisor 又用 www 用户启动，先把权限改好再继续，避免首次启动写入运行目录和前端资源时失败。
四、首次安装直接进入安装页
当前 v1.0.3 全新部署时，不需要先手动创建或编辑 /www/wwwroot/epusdt/.env。
只要目录里还没有现成的 .env，程序首次启动后就会直接进入安装页，基础配置在安装页里填写即可。
进入安装页后只需要把 App URI 改成你的正式域名，其他保持默认即可。
五、Nginx 反向代理
宝塔 / aaPanel 反向代理目标地址填：
http://127.0.0.1:8000
如果你习惯手写 Nginx，核心配置如下：
location / {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
对外只开放 80 和 443 即可。
六、SSL
- 进入网站设置
- 打开「SSL」
- 为域名申请证书
- 开启「强制 HTTPS」
七、Supervisor 启动方式
如果你使用宝塔 / aaPanel Supervisor，建议按下面填写：
- 名称：
epusdt - 运行用户：
www - 启动目录：
/www/wwwroot/epusdt - 启动命令：
/www/wwwroot/epusdt/epusdt http start - 自动启动：开启
- 自动重启：开启
八、首次启动安装向导
- 在 Supervisor 里启动
epusdt - 浏览器访问你的域名，例如
https://pay.example.com/ - 全新部署且目录里没有
.env时，会直接进入安装页
进入安装页后，正常只需要把 App URI 改成你的正式域名，其他保持默认即可完成安装。
安装完成后，再到后台补齐汇率 API、Telegram、钱包地址、链和支付设置即可。
九、获取后台初始账号密码
安装成功后，页面会直接显示后台初始账号信息：
- 用户名固定为
admin - 密码为随机生成的一次性初始密码
如果安装成功页没有显示出密码，也可以在安装完成后调用一次：
GET /admin/api/v1/auth/init-password
后台登录页路径：
https://pay.example.com/sign-in
十、安装完成后继续处理
- 登录后台，先修改管理员密码
- 在后台补上汇率 API 地址：
https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1/currencies/ - 补齐 Telegram、通知、收款地址、链和 RPC 设置
- 按你的接入方式继续配置 GMPay、EPay 或 OKPay 相关内容
- 做一笔测试订单，确认金额换算、二维码和回调都正常
