# frpc-manager

**Repository Path**: lindeyi/frpc-manager

## Basic Information

- **Project Name**: frpc-manager
- **Description**: frpc透传代理管理器
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: frpc, frpc-ui, 内网穿透, 穿透可视化, 穿透管理器

## README

# frpc 透传管理服务

局域网侧 Web 管理端：维护 HTTP / TCP 透传配置 → 生成 `frpc.toml` → 通过内置脚本启停 frpc。

系统显示名称可通过 `configs/config.yaml` 中的 `app_name` 配置。

## 界面预览

### 登录

![登录页](images/login.png)

### 透传列表

![主界面](images/main.png)

### 新建 / 编辑

![编辑透传](images/edit.png)

## 功能

- 账号密码登录
- 透传 CRUD、启用/暂停、过期自动停用
- 支持 HTTP（子域名）与 TCP（远程端口）
- 从现有 `frpc.toml` 同步到管理端
- 启用/暂停/删除后自动写入 `frpc.toml`（不自动重启）
- 手动「应用配置 / 重启 frpc / 应用并重启」
- 配置导入导出
- 展示 frpc 运行状态与配置路径

## 目录

```
cmd/server/          # 入口
internal/            # 后端
web/                 # Vue3 前端（构建产物 embed 进二进制）
scripts/             # frpc 启停脚本
configs/             # 配置示例
docs/                # 需求与设计
images/              # README 截图
```

## 快速开始

### 1. 配置

```bash
cp configs/config.example.yaml configs/config.yaml
# 编辑：app_name、密码、frpc.binary_path、server_addr 等
chmod +x scripts/frpc-start.sh scripts/frpc-stop.sh
```

把本机 `frpc` 放到 `binary_path` 指定位置（默认 `./bin/frpc`），或改成绝对路径。

### 2. 构建

```bash
# 前端
cd web && npm install && npm run build && cd ..

# 后端（会 embed web/dist）
go build -o bin/frpc-manager ./cmd/server
```

Linux 服务器打包：

```bash
make dist-linux
```

详见 [docs/打包与后台运行.md](docs/打包与后台运行.md)。

### 3. 运行

```bash
./bin/frpc-manager -config configs/config.yaml
```

浏览器打开 `http://<局域网IP>:8088`，默认账号见配置文件。

### 开发模式

```bash
# 终端 1：后端
go run ./cmd/server -config configs/config.yaml

# 终端 2：前端（代理 /api → :8088）
cd web && npm run dev
```

## 公网一次性配置

nginx 使用通配符，无需再为每个子域加 server：

```nginx
server {
    listen 80;
    client_max_body_size 100M;
    server_name *.example.com;
    location / {
        proxy_pass http://127.0.0.1:8130/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Connection "";
        proxy_http_version 1.1;
        proxy_buffering off;
        proxy_cache off;
        chunked_transfer_encoding off;
    }
}
```

DNS：`*.example.com` → 公网机。

## 行为说明

| 操作 | 写 toml | 重启 frpc |
|------|---------|-----------|
| 新建 | 否（默认未启用） | 否 |
| 启用 / 暂停 / 删除（已启用项） | 是 | 否 |
| 同步 frpc.toml | 否（只读入 DB） | 否 |
| 应用配置 | 是 | 否 |
| 重启 frpc | 否 | 是 |
| 应用并重启 | 是 | 是 |
| 到期扫描禁用 | 是 | 否 |

启用后请点 **重启 frpc**（或 **应用并重启**）使 frpc 进程加载新配置。