# go-remote

**Repository Path**: cxy20219/go-remote

## Basic Information

- **Project Name**: go-remote
- **Description**: SSH 隧道内网穿透系统 - 通过 WebSocket 隧道暴露内网服务。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-15
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GoRemote

基于 WebSocket 的零配置内网穿透系统。每设备独立 AES-256-GCM 加密，审批制注册，一键部署。

## 试用效果图

零配置内网穿透：服务端一键启动，Agent 只填写服务器地址，管理员审批后即可创建 SSH/HTTP 等内网服务映射。

## 功能特性

- **零配置启动** — `./server` 一键启动，admin 密码自动生成；Agent 仅需服务器地址
- **审批制注册** — Agent 基于 ed25519 身份认证，管理员 Web 端一键批准/拒绝
- **每设备独立加密** — 审批时通过 X25519 ECDH 协商 AES-256-GCM 密钥，且支持 Web UI 随时轮换
- **Web 管理面板** — 设备管理、隧道 CRUD、安全策略配置、系统设置全套界面
- **安全机制** — 管理员改密与登录锁定、连接/端口扫描限流、自动黑名单、全局/设备级 IP 白名单
- **心跳保活 + 指数退避重连** — 网络中断后 ed25519 签名快速重认证，自动恢复

## 安全特性

- **审批制接入**：新 Agent 首次连接只会进入 pending 状态，必须由管理员在 Web 面板批准后才能创建隧道。
- **设备身份认证**：每个 Agent 本地生成 ed25519 身份密钥，重连时使用签名认证，避免仅凭 client ID 冒充设备。
- **每设备独立密钥**：每台设备单独协商 AES-256-GCM 隧道数据密钥，支持按设备关闭加密或重新生成密钥。
- **密钥交换保护**：服务端下发的密钥更新带签名，Agent 首次信任后会校验后续 `register_ok` / `register_update`，防止密钥更新被篡改。
- **防重放**：设备重连签名带时间戳，服务端限制时间窗口并记录已使用签名，减少重放风险。
- **管理面加固**：支持管理员改密、登录失败临时锁定、HttpOnly Cookie，会话修改密码后自动吊销。
- **敏感状态加密**：可通过 `GOREMOTE_STATE_KEY` 或 `--state-key` 加密 `server-state.json` 中的服务端私钥、管理员密码 hash 和设备隧道密钥。
- **访问控制**：支持全局/设备级 IP 白名单、黑名单和自动拉黑。
- **端口防扫描**：隧道公网端口带连接频率限制，异常扫描会被拒绝并可触发自动黑名单。

## 一句话部署

### 服务端

```bash
wget -qO server https://github.com/xxx/goremote/releases/latest/download/server-linux-amd64 && chmod +x server && ./server
```

首次启动自动打印 admin 密码，浏览器打开 `http://your-ip:8080/` 登录即可。

### 客户端

```bash
wget -qO agent https://github.com/xxx/goremote/releases/latest/download/agent-linux-amd64 && chmod +x agent && ./agent --server <server-ip>:8080
```

Agent 自动创建 `~/.goremote/identity`（ed25519 身份密钥），连接服务器后进入待审批状态，管理员批准后自动进入工作状态。

## 手动部署

### 服务端

```bash
# 1. 下载二进制
wget https://github.com/xxx/goremote/releases/latest/download/server-linux-amd64
chmod +x server-linux-amd64

# 2. 启动（可选参数：--port 8080 --data ./data --tls-cert cert.pem --tls-key key.pem）
./server-linux-amd64

# 可选：启用状态文件敏感字段加密，生产环境建议使用随机 32 字节以上密钥
GOREMOTE_STATE_KEY='CHANGE-ME-long-random-state-key' ./server-linux-amd64

# 3. 查看 admin 密码
tail -n 20 server.log  # 或直接查看控制台输出
```

### 客户端

```bash
# 1. 下载对应平台二进制
wget https://github.com/xxx/goremote/releases/latest/download/agent-linux-amd64
chmod +x agent-linux-amd64

# 2. 启动（可选参数：--tls 启用 WSS，--tls-ca 指定 CA）
./agent-linux-amd64 --server YOUR_SERVER:8080

# 如需后台运行
nohup ./agent-linux-amd64 --server YOUR_SERVER:8080 --log-file agent.log --log-max-size-mb 50 --log-max-backups 5 > /dev/null 2>&1 < /dev/null &
```

## 编译

```bash
swag init -g cmd/server/main.go -o docs
GOOS=linux   GOARCH=amd64 go build -ldflags="-s -w" -o server-linux-amd64 ./cmd/server
GOOS=linux   GOARCH=arm64 go build -ldflags="-s -w" -o agent-linux-arm64  ./cmd/agent
GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o agent-windows-amd64.exe ./cmd/agent
GOOS=darwin  GOARCH=amd64 go build -ldflags="-s -w" -o agent-darwin-amd64 ./cmd/agent
```