主题
安装部署
易发卡 / EasyCard 为单二进制部署，程序名为 cardgo（Windows：cardgo.exe）。发行包发布于 GitHub Releases。
环境要求
- Windows x64，或 Linux amd64 / arm64
- 可写工作目录（存放
config.json、数据库等） - 默认监听端口 8080（可改）
- 生产环境建议：公网 HTTPS（支付回调需要可访问的
base_url）
Windows 安装
- 下载
EasyCard-1.0.0-windows-amd64.zip - 解压到任意目录（例如
D:\EasyCard\） - 运行
cardgo.exe - 浏览器打开 http://127.0.0.1:8080/admin 完成首次安装向导
建议在防火墙中放行入站端口（默认 8080）。数据与配置一般写在程序目录（如 config.json、data.db，以实际配置为准）。
Linux 一键安装（推荐）
需要 curl、tar 与 root 权限；支持 amd64 / arm64。
bash
curl -fsSL https://raw.githubusercontent.com/ecard8/EasyCard/main/install.sh | sudo bash指定版本、目录、端口：
bash
curl -fsSL https://raw.githubusercontent.com/ecard8/EasyCard/main/install.sh -o install.sh
sudo bash install.sh --version 1.0.0 --dir /opt/easycard --port 8080安装脚本会：
- 下载对应架构的
EasyCard-*-linux-*.tar.gz - 默认安装到
/opt/easycard - 创建系统用户
easycard与 systemd 服务easycard - 生成默认
config.json（若不存在）并启动服务
首次打开管理端完成安装向导：
text
http://服务器IP:8080/admin常用运维
bash
systemctl status easycard
systemctl restart easycard
journalctl -u easycard -f升级（保留数据与配置）：
bash
sudo bash install.sh --version 1.0.0 -y
# 或安装最新版
sudo bash install.sh -y卸载（默认保留数据目录）：
bash
sudo systemctl disable --now easycard
sudo rm -f /etc/systemd/system/easycard.service
sudo systemctl daemon-reload
# 可选：sudo rm -rf /opt/easycardLinux 手动安装
bash
VER=1.0.0
ARCH=amd64 # 或 arm64
curl -fLO "https://github.com/ecard8/EasyCard/releases/download/v${VER}/EasyCard-${VER}-linux-${ARCH}.tar.gz"
mkdir -p /opt/easycard/data
tar -xzf "EasyCard-${VER}-linux-${ARCH}.tar.gz" -C /opt/easycard
chmod +x /opt/easycard/cardgo
cd /opt/easycard
./cardgo可选 config.json（也可首次由程序自动生成，或通过 /admin 安装向导创建）：
json
{
"listen": ":8080",
"db_path": "data/data.db",
"base_url": "http://你的域名或IP:8080"
}反向代理时请正确设置 base_url（含 https://），并配置 trusted_proxies（如有）。
健康检查
服务正常时可访问：
text
GET /health升级注意
- 阅读 更新日志
- 备份
config.json（尤其是aes_key）与数据库 - 覆盖二进制或重新运行
install.sh - 验证管理端、店铺前台与支付回调