Go Gateway

外观

📦 软件安装指南 ​

📋 前置准备 ​

在开始安装之前，请确保您的服务器满足以下要求：

系统要求

  • 操作系统：支持 Linux (CentOS, Ubuntu, Debian 等) / Windows / macOS
  • 系统架构：仅支持 64 位系统 (x86_64/AMD64, ARM64)
  • 内存要求：建议 ≥ 1GB
  • 磁盘空间：建议 ≥ 10GB
  • 端口要求：默认占用 8080 端口（可在配置文件中修改）

📥 下载安装包 ​

根据您的服务器架构选择对应的安装包：

shell
# Windows 64位
https://software.wueasy.com/gateway-go/latest/gateway_go_win_64.zip
shell
# Linux (Intel/AMD处理器)
https://software.wueasy.com/gateway-go/latest/gateway_go_linux_amd64.tar.gz
shell
# Linux (飞腾/鲲鹏等ARM处理器)
https://software.wueasy.com/gateway-go/latest/gateway_go_linux_arm64.tar.gz
shell
# Mac (M1/M2/M3芯片)
https://software.wueasy.com/gateway-go/latest/gateway_go_mac_arm64.tar.gz

# Mac (Intel处理器)
https://software.wueasy.com/gateway-go/latest/gateway_go_mac_amd64.tar.gz

如何查看系统架构？

在 Linux/macOS 终端执行 uname -m：

  • 输出 x86_64：选择 Linux x86_64 或 Mac Intel 版本
  • 输出 aarch64 或 arm64：选择 Linux ARM64 或 Mac ARM64 版本

🚀 快速安装 ​

1. 解压文件 ​

建议将程序安装在 /srv/gateway (Linux) 或 C:\gateway (Windows) 目录下。

bash
# 1. 创建目录并下载（以Linux x86_64为例）
mkdir -p /srv/gateway && cd /srv/gateway
wget https://software.wueasy.com/gateway-go/latest/gateway_go_linux_amd64.tar.gz

# 2. 解压文件
tar -zxvf gateway_go_linux_amd64.tar.gz

# 3. 赋予执行权限
chmod +x gateway_linux_amd64
cmd
# 1. 下载压缩包并解压
# 2. 将解压后的文件夹移动到 C:\gateway
# 3. 进入目录
cd C:\gateway

2. 安装服务 ​

⚠️ 重要提醒

必须先执行 install 命令！这会将网关注册为系统服务，确保能通过系统命令管理并在后台运行。

bash
# 需要 root 权限
sudo ./gateway_linux_amd64 install

# 成功输出：
# 安装服务成功
cmd
# 以管理员身份运行 CMD
gateway_win_64.exe install

# 成功输出：
# 安装服务成功

3. 启动服务 ​

bash
# 启动服务
sudo ./gateway_linux_amd64 start

# 或者使用 systemctl
sudo systemctl start gateway
cmd
# 启动服务
gateway_win_64.exe start

4. 验证安装 ​

服务启动后（默认端口 8080），可以通过以下方式验证：

bash
# 检查端口监听
netstat -tlnp | grep 8080

# 发送测试请求
curl http://127.0.0.1:8080/
bash
# 在浏览器访问
http://localhost:8080/

5. 配置文件设置（可选） ​

推荐配置结构

为了更好地组织配置文件，建议创建 config/ 子目录：

bash
# 创建配置目录
mkdir -p config/i18n

# 将配置文件移入（如果已存在）
# mv config.yaml config/
# mv i18n/* config/i18n/
cmd
# 创建配置目录
mkdir config
mkdir config\i18n

# 将配置文件移入（如果已存在）
# move config.yaml config\
# move i18n\* config\i18n\

程序会自动按以下优先级查找配置：

  1. 优先：config/config.yaml 和 config/i18n/
  2. 备选：根目录的 config.yaml 和 i18n/

📂 目录结构说明 ​

安装完成后的建议目录结构如下：

plaintext
/srv/gateway/
├── gateway_linux_amd64    # 主程序文件
├── config.yaml           # 配置文件（根目录，可选）
├── config/               # 配置目录（推荐）
│   ├── config.yaml      # 主配置文件
│   └── i18n/            # 国际化配置目录
│       ├── zh-CN.yaml   # 中文配置
│       ├── en-US.yaml   # 英文配置
│       └── ...          # 其他语言配置
├── i18n/                 # 国际化配置目录（根目录，可选）
├── logs/                 # 日志目录
│   ├── app.log          # 应用日志
└── license.dat           # 授权文件

配置文件优先级

程序会按以下优先级查找配置文件：

  1. config 子目录：优先从 config/config.yaml 和 config/i18n/ 读取（推荐）
  2. 根目录：如果 config/ 目录不存在，则从根目录的 config.yaml 和 i18n/ 读取

建议使用 config/ 子目录，这样可以更好地组织配置文件，保持根目录整洁。

🛠️ 命令参考手册 ​

服务管理命令 ​

功能Linux 命令Windows 命令说明
安装服务./gateway installgateway.exe install注册系统服务（首选）
启动服务./gateway startgateway.exe start启动后台服务
停止服务./gateway stopgateway.exe stop停止后台服务
重启服务./gateway restartgateway.exe restart重启服务
查看状态./gateway statusgateway.exe status查看运行状态
卸载服务./gateway uninstallgateway.exe uninstall移除系统服务

注：命令中的 gateway 指代实际的程序名称，如 gateway_linux_amd64。

系统服务管理 (Linux Only) ​

安装后，您也可以使用标准的 systemctl 命令管理：

bash
# 启动/停止/重启
sudo systemctl start gateway
sudo systemctl stop gateway
sudo systemctl restart gateway

# 查看状态
sudo systemctl status gateway

# 开机自启设置
sudo systemctl enable gateway  # 开启自启
sudo systemctl disable gateway # 关闭自启

🔧 常见问题 (FAQ) ​

Q1: 启动时提示 "Permission denied"？ ​

A: 权限不足。请确保：

  1. 程序文件有执行权限：chmod +x gateway_linux_amd64
  2. 使用 sudo 或 root 用户执行命令。

Q2: 执行 start 命令无反应或失败？ ​

A:

  1. 确保已经先执行了 install 命令。
  2. 检查日志文件（通常在 logs/ 目录下）查看错误信息。
  3. Linux 下检查 SELinux 设置：
    bash
    # 临时测试是否为 SELinux 问题
sudo setenforce 0

# 永久修复文件上下文
sudo chcon -R -t bin_t /srv/gateway/gateway_linux_amd64

Q3: 如何修改默认端口？ ​

A: 修改配置文件（推荐在 config/config.yaml，如果没有请新建），添加如下配置：

yaml
server:
  port: 9090 # 修改为你需要的端口

修改后需重启服务：./gateway restart。

配置文件位置

  • 推荐：创建 config/config.yaml（程序会优先读取此位置）
  • 备选：在根目录创建 config.yaml（当 config/ 目录不存在时使用）

Q4: 无法从外部访问？ ​

A: 请检查服务器防火墙设置，放行对应端口：

bash
# CentOS/RedHat (firewalld)
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --reload

# Ubuntu/Debian (ufw)
sudo ufw allow 8080/tcp

Q5: 如何组织配置文件？ ​

A: 推荐使用 config/ 子目录来管理所有配置文件：

bash
# 创建配置目录结构
mkdir -p config/i18n

# 将配置文件放入 config 目录
mv config.yaml config/
mv i18n/* config/i18n/

优势：

  • ✅ 根目录更整洁，只保留可执行文件和授权文件
  • ✅ 配置文件集中管理，便于备份和迁移
  • ✅ 程序会自动优先读取 config/ 目录下的配置
  • ✅ 如果 config/ 目录不存在，会自动降级到根目录读取（向后兼容）

Q6: 配置文件在哪里？ ​

A: 程序启动时会在日志中输出配置文件的实际读取位置：

配置根目录: /srv/gateway/config
初始化国际化配置，默认语言: zh-CN, i18n目录: /srv/gateway/config/i18n

查看日志即可确认程序使用的配置路径。

Copyright © 2017-2026 wueasy.com