EPusdt v0.9.3 宝塔 / aaPanel 全新部署教程

教程说明

这篇教程基于官方 GMWalletApp/epusdt v0.9.3 整理，只讲宝塔 / aaPanel 全新部署官方原版。

一、准备

• Linux 服务器
• 宝塔 / aaPanel
• Nginx 和 Supervisor
• 一个已经解析到服务器的域名，例如 pay.example.com
• 放行 80 和 443 端口

二、创建站点

1. 进入宝塔 / aaPanel 的「网站」
2. 新增站点，域名填你的正式域名
3. 站点目录填 /www/wwwroot/epusdt
4. PHP 版本选「纯静态」

三、下载官方发布包

先确认服务器架构：

uname -m

• x86_64 下载 epusdt-0.9.3-linux-amd64.tar.gz
• aarch64 下载 epusdt-0.9.3-linux-arm64.tar.gz

打开官方发布页下载：

https://github.com/GMWalletApp/epusdt/releases/tag/v0.9.3

1. 在浏览器打开上面的 release 页面
2. 下载 epusdt-0.9.3-linux-amd64.tar.gz
3. 把压缩包上传到 /www/wwwroot/epusdt

在宝塔 / aaPanel 文件管理器里直接解压压缩包，双击压缩包或右键解压到当前目录都可以。

解压完成后执行：

cd /www/wwwroot/epusdt
chmod 755 epusdt

四、先准备.env，剩下到安装页再填

在宝塔 / aaPanel 文件管理器里，把 .env.example 直接重命名为 .env 。

首次安装时，先保留默认值即可，不用急着手工填写一堆参数。

后面程序启动后，直接访问 https://pay.example.com/install 完成安装。

如果你直接打开根域名， v0.9.3 首次安装时也会自动跳到 /install 。

app_uri 不要求你在启动前就先手工写进 .env ；直接在安装页里填写也可以。

如果你习惯先把域名写好，也可以提前改这一行：

app_uri=https://pay.example.com

如果启动后直接看到后台登录页，说明当前生效的 .env 很可能已经是 install=false 。

五、Nginx 反向代理

反向代理目标填：

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;
}

六、SSL

1. 进入网站设置
2. 打开「SSL」
3. 申请证书
4. 开启「强制 HTTPS」

七、Supervisor

宝塔 / aaPanel 里只填这几个就够了：

• 名称： epusdt
• 运行用户： www
• 运行目录： /www/wwwroot/epusdt
• 启动命令： /www/wwwroot/epusdt/epusdt http start

保存后启动，确认进程状态正常即可。

八、启动安装向导

1. 先启动 Supervisor 里的 epusdt
2. 访问 https://pay.example.com/install ；直接打开根域名也会自动跳到这里
3. 按页面完成安装
4. 安装完成后程序会把 install 自动改成 false
5. 安装成功页会直接显示后台初始账号和一次性随机密码，请当场复制保存
6. 然后进入 https://pay.example.com/sign-in 登录

后台登录页路径是 /sign-in ，

九、安装后最少要做

1. 后台补齐你自己的设置
2. 添加至少 1 个钱包地址
3. 检查链、代币、RPC 是否正常
4. 系统配置里补齐汇率 API 地址

https://cdn.jsdelivr.net/npm/@fawazahmed0/currency-api@latest/v1/currencies/

十、官方链接

• v0.9.3 Release
• 官方仓库