项目地址：https://github.com/InvertGeek/directlink

开发初衷：相关项目放入docker中运行，所有代码由AI完成，本人只负责调试


![m3j2dytk.f5x.png](/static/img/20c2bedbf058c72586bc5ccfa21ed426.m3j2dytk.f5x.webp)

# Docker 部署说明

---

## 快速开始

```bash
chmod +x setup.sh
./setup.sh
```

**就这一条命令！**

---

## 脚本功能

- 自动检测架构（x86_64/ARM64/ARMv7）
- 自动下载对应版本
- 支持国内镜像加速
- 自动验证文件完整性
- 一键启动服务

---

## 管理命令

```bash
docker compose up -d        # 启动
docker compose stop         # 停止  
docker compose restart      # 重启
docker compose logs -f      # 日志
docker compose ps           # 状态
```

---

## 修改端口

```bash
# 1. 修改配置
nano settings.toml
# 改为: port = 8888

# 2. 修改端口映射  
nano docker-compose.yml
# 改为: ports: "8888:8888"

# 3. 重启
docker compose restart
```

---

## 国内用户

如果下载失败（文件 0KB）：

运行脚本时选择 **1（国内镜像）**

或手动下载后上传到当前目录，重命名为 `directlink`

---

## 访问

部署成功后访问：`http://服务器IP:8080`

源码下载地址：[蓝奏云](https://wwwo.lanzouq.com/iRHb339jwsna)



DirectLink 部署工具

# FRPC Docker 多实例部署说明文档

## 📋 项目简介

本项目使用 Docker Compose 部署多个 FRPC（Fast Reverse Proxy Client）实例，实现内网穿透服务的高可用性。说明文档全部由ai生成，相关配置文件由本人修改。

### 为什么需要部署多个 FRPC 实例？

在传统的单 FRPC 部署方案中，存在以下问题：
- **单点故障风险**：如果唯一的 FRPC 实例出现问题或者对应的 FRPS 服务器失联，所有下游终端都会失去连接
- **服务可用性低**：无法实现故障转移和负载均衡
- **维护困难**：更新或重启服务时会导致所有连接中断

**解决方案**：通过 Docker 部署多个 FRPC 实例，连接到不同的 FRPS 服务器，实现：
- ✅ 高可用性：一个 FRPS 失联不影响其他连接
- ✅ 故障转移：自动切换到可用的服务器
- ✅ 易于管理：Docker 容器化管理，重启和更新更方便
- ✅ 资源隔离：每个实例独立运行，互不影响

---

## 🚀 快速开始

### 环境要求

- Docker（内置 Docker Compose V2）

### 目录结构


## 📝 配置文件说明

### 1. docker-compose.yml 配置

```yaml
services:
    frps:                                    # 服务名称
        container_name: frpc1                # 容器名称（建议修改为有意义的名称）
        image: snowdreamtech/frpc:latest     # FRPC 镜像（建议指定版本号）
        labels:
            createdBy: Apps                  # 标签，用于标识创建者
        network_mode: host                   # 使用宿主机网络（重要！）
        restart: always                      # 容器自动重启策略
        volumes:
            - ./data/frpc.toml:/etc/frp/frpc.toml  # 挂载配置文件
```

#### 配置项说明：

| 配置项 | 说明 | 建议 |
|--------|------|------|
| `container_name` | 容器名称，用于标识不同的实例 | 使用有意义的名称，如 frpc-aliyun、frpc-tencent |
| `image` | Docker 镜像 | 建议使用固定版本号，如 `snowdreamtech/frpc:0.63.0` |
| `network_mode: host` | 使用主机网络模式 | **必须保持**，否则内网穿透无法正常工作 |
| `restart: always` | 自动重启策略 | 保持 always，确保服务持续运行 |
| `volumes` | 配置文件挂载路径 | 根据实际路径调整 |

### 2. frpc.toml 配置文件格式

FRPC 使用 TOML 格式配置文件（新版本已不再使用 INI 格式）。

#### 完整配置示例：

```toml
# ============================================
# FRPC 新版 TOML 配置
# ============================================

# ---- 全局配置 ----
serverAddr = "frp.example.com"              # FRPS 服务器地址（IP或域名）
serverPort = 7000                           # FRPS 服务器端口
auth.method = "token"                       # 认证方式
auth.token = "your_token_here"              # 认证密钥（必须与服务端一致）

# Web 管理界面配置（可选）
webServer.addr = "127.0.0.1"                # Web 界面监听地址
webServer.port = 7400                       # Web 界面端口（不同实例需使用不同端口）
webServer.user = "admin"                    # Web 界面用户名
webServer.password = "password"             # Web 界面密码

# ---- 代理配置 ----
# TCP 代理示例
[[proxies]]
name = "ssh"                                # 代理名称（必须唯一）
type = "tcp"                                # 代理类型：tcp/udp/http/https
localIP = "192.168.1.100"                   # 本地目标服务器IP
localPort = 22                              # 本地目标服务器端口
remotePort = 6000                           # 远程服务器映射端口

# HTTP 代理示例
[[proxies]]
name = "web"
type = "http"
localIP = "192.168.1.100"
localPort = 80
customDomains = ["www.example.com"]         # 自定义域名

# HTTPS 代理示例
[[proxies]]
name = "web-ssl"
type = "https"
localIP = "192.168.1.100"
localPort = 443
customDomains = ["www.example.com"]

# UDP 代理示例
[[proxies]]
name = "dns"
type = "udp"
localIP = "192.168.1.100"
localPort = 53
remotePort = 6001
```

#### 配置项详细说明：

##### 全局配置部分

| 配置项 | 必填 | 说明 | 示例 |
|--------|------|------|------|
| `serverAddr` | ✅ | FRPS 服务器地址 | `"frp.example.com"` 或 `"1.2.3.4"` |
| `serverPort` | ✅ | FRPS 服务器端口 | `7000` |
| `auth.method` | ✅ | 认证方式 | `"token"` |
| `auth.token` | ✅ | 认证密钥 | `"your_secret_token"` |
| `webServer.addr` | ❌ | Web 管理界面地址 | `"127.0.0.1"` |
| `webServer.port` | ❌ | Web 管理界面端口 | `7400` |
| `webServer.user` | ❌ | Web 界面用户名 | `"admin"` |
| `webServer.password` | ❌ | Web 界面密码 | `"password"` |

##### 代理配置部分

每个代理配置使用 `[[proxies]]` 开头，支持以下配置：

| 配置项 | 必填 | 说明 | 适用类型 |
|--------|------|------|----------|
| `name` | ✅ | 代理名称（唯一标识） | 所有类型 |
| `type` | ✅ | 代理类型 | `tcp`/`udp`/`http`/`https`/`stcp`/`xtcp` |
| `localIP` | ✅ | 本地目标IP地址 | 所有类型 |
| `localPort` | ✅ | 本地目标端口 | 所有类型 |
| `remotePort` | ✅ | 远程映射端口 | `tcp`/`udp` |
| `customDomains` | ✅ | 自定义域名（数组） | `http`/`https` |
| `subdomain` | ❌ | 子域名 | `http`/`https` |

---

## 🔧 启动命令

> **⚠️ 命令格式说明**：
> 
> 本文档使用 **Docker Compose V2** 的命令格式：`docker compose`（带空格）
> 
> - ✅ **推荐使用**：`docker compose` （Docker Compose V2，Docker 内置插件）
> - ❌ **旧版本**：`docker-compose` （Docker Compose V1，独立命令行工具）
> 
> Docker Compose V2 已集成到 Docker CLI 中，无需单独安装。如果你的系统仍使用 V1，建议升级到最新版本的 Docker。

### 启动单个实例

```bash
# 进入对应目录
cd frpc

# 启动容器（后台运行）
docker compose up -d

# 查看容器日志
docker compose logs -f

# 停止容器
docker compose down

# 重启容器
docker compose restart
```


### 常用管理命令

```bash
# 查看所有 FRPC 容器状态
docker ps -a | grep frpc

# 查看特定容器日志
docker logs -f frpc1

# 进入容器内部
docker exec -it frpc1 sh

# 重启所有 FRPC 容器
docker restart $(docker ps -a | grep frpc | awk '{print $1}')

# 停止所有 FRPC 容器
docker stop $(docker ps -a | grep frpc | awk '{print $1}')

# 更新镜像
docker compose pull
docker compose up -d
```

---

## 📊 多实例部署策略

### 推荐配置方案

1. **主备模式**
   - 主实例：连接主 FRPS 服务器
   - 备用实例：连接备用 FRPS 服务器
   - 使用相同的代理配置和端口

2. **负载均衡模式**
   - 多个实例连接不同的 FRPS 服务器
   - 不同服务分配到不同实例
   - 分散负载，提高性能

3. **地域分布模式**
   - 根据 FRPS 服务器地理位置选择
   - 降低延迟，提高访问速度

### 注意事项

⚠️ **重要提示**：

1. **Web 管理端口冲突**：每个实例的 `webServer.port` 必须不同
   ```toml
   # 实例1
   webServer.port = 7400
   
   # 实例2
   webServer.port = 7401
   
   # 实例3
   webServer.port = 7402
   ```

2. **容器名称唯一性**：每个容器的 `container_name` 必须不同

3. **代理名称唯一性**：同一 FRPS 服务器上的代理名称不能重复

4. **端口映射冲突**：不同实例连接同一 FRPS 时，`remotePort` 不能重复

5. **配置文件路径**：确保 `volumes` 挂载路径正确

---

## 🔍 故障排查

### 常见问题

1. **容器无法启动**
   ```bash
   # 查看详细错误信息
   docker compose logs
   
   # 检查配置文件语法
   docker run --rm -v $(pwd)/frpc.toml:/frpc.toml snowdreamtech/frpc:latest /usr/bin/frpc verify -c /frpc.toml
   ```

2. **无法连接 FRPS**
   - 检查 `serverAddr` 和 `serverPort` 是否正确
   - 检查 `auth.token` 是否与服务端一致
   - 检查网络连接和防火墙设置

3. **端口映射失败**
   - 确认 `remotePort` 在 FRPS 允许范围内
   - 检查端口是否被占用
   - 确认 `network_mode: host` 已正确配置

4. **配置修改后不生效**
   ```bash
   # 重启容器使配置生效
   docker compose restart
   ```

### 日志查看

```bash
# 实时查看日志
docker compose logs -f

# 查看最近 100 行日志
docker compose logs --tail=100

# 查看特定时间段日志
docker logs --since="2024-01-01" --until="2024-01-02" frpc1
```

---

## 📚 参考资源

- [FRP 官方文档](https://github.com/fatedier/frp)
- [Docker Compose V2 官方文档](https://docs.docker.com/compose/)
- [Docker Compose V2 迁移指南](https://docs.docker.com/compose/migrate/)
- [TOML 格式说明](https://toml.io/)

---

## 📝 更新日志

- **v1.0** - 初始版本，支持多实例部署
  - 使用 Docker Compose V2 管理容器
  - 采用 `docker compose` 命令格式（而非旧版的 `docker-compose`）
  - 支持 TOML 配置格式
  - 提供完整的配置说明和启动命令

---

## 💡 技术支持

如有问题，请检查：
1. Docker 和 Docker Compose 是否正确安装
2. 配置文件格式是否正确
3. FRPS 服务器是否可访问
4. 防火墙和网络设置是否正确

---

compose文件及toml配置文件下载地址：[蓝奏云](https://wwwo.lanzouq.com/iPQsN38mmila)



frpc-docker版本

# 中国大陆IP访问控制脚本

## 介绍
这是一个用于Ubuntu系统的Shell脚本，用于限制您的机器只能被中国大陆IP地址访问，或者说禁止国外IP访问。脚本使用iptables实现IP访问控制，并提供了方便的开启、关闭、状态查看和验证功能。脚本全部由AI工具生成

## 功能特点
1. **方便的开关控制**：通过简单的命令即可开启或关闭IP访问限制功能
2. **状态查看**：可以随时查看当前IP限制的状态和规则数量
3. **重启后生效**：通过systemd服务确保重启后规则仍然有效
4. **验证功能**：可以验证当前公网IP是否在中国IP段内
5. **自动获取IP段**：从可靠源自动获取最新的中国大陆IP段列表

## 安装说明

### 前提条件
- Ubuntu或其他基于Debian的Linux系统
- 已安装iptables（系统一般默认已安装）
- 具有root权限

### 安装步骤
1. 将脚本复制到您的Ubuntu系统中
2. 给脚本添加执行权限：
   ```bash
   sudo chmod +x china_ip_access.sh
   ```

## 使用方法

### 基本用法
```bash
sudo ./china_ip_access.sh [选项]
```

### 可用选项
- `start`：开启IP访问限制功能
- `stop`：关闭IP访问限制功能
- `status`：查看当前IP访问限制状态
- `check`：验证当前IP是否被允许访问
- `help`：显示帮助信息

### 使用示例

#### 开启IP访问限制
```bash
sudo ./china_ip_access.sh start
```

运行此命令后，脚本会：
1. 从互联网获取最新的中国大陆IP段列表
2. 设置iptables规则，仅允许中国大陆IP访问
3. 创建并启用systemd服务，确保重启后规则仍然生效

#### 关闭IP访问限制
```bash
sudo ./china_ip_access.sh stop
```

运行此命令后，脚本会：
1. 移除之前设置的iptables规则
2. 保存更改，确保重启后也不会应用这些规则

#### 查看状态
```bash
sudo ./china_ip_access.sh status
```

此命令将显示：
1. IP限制功能的当前状态（开启/关闭）
2. 设置的规则数量
3. 最近更新时间
4. systemd服务的状态

#### 验证访问
```bash
sudo ./china_ip_access.sh check
```

此命令将：
1. 检查是否有有效的IP限制规则
2. 获取您的公网IP地址
3. 验证您的IP是否在中国IP段列表中

## 工作原理

### IP段获取
脚本从以下可靠源获取中国大陆IP段列表（按优先级）：
1. https://ispip.clang.cn/all_cn_cidr.txt
2. https://raw.githubusercontent.com/gaoyifan/china-operator-ip/master/china.txt

### 规则设置
脚本通过iptables设置以下规则：
1. 创建一个名为`CHINA_IP_ACCESS`的自定义链
2. 允许本地回环（lo）访问
3. 允许已建立的连接
4. 添加所有中国大陆IP段到允许列表
5. 默认拒绝所有其他IP访问
6. 将自定义链插入到INPUT链的最前面

### 持久化
脚本通过两种方式确保重启后规则仍然生效：
1. 使用`iptables-save`保存规则到`/etc/iptables/rules.v4`
2. 创建systemd服务`china-ip-access.service`，在系统启动时自动加载规则

## 注意事项

1. **权限要求**：脚本必须以root权限运行
2. **网络连接**：首次运行需要互联网连接以获取中国大陆IP段列表
3. **兼容性**：脚本适用于Ubuntu和其他基于Debian的Linux系统
4. **备份规则**：在运行脚本前，建议备份当前的iptables规则：
   ```bash
   iptables-save > ~/iptables_backup.rules
   ```
   需要恢复时可以使用：
   ```bash
   iptables-restore < ~/iptables_backup.rules
   ```
5. **更新IP段**：如果需要更新中国大陆IP段列表，只需重新运行`start`命令

## 故障排除

### 无法获取IP段列表
- 检查您的网络连接是否正常
- 确保您可以访问脚本中指定的IP段列表源

### 规则不生效
- 检查iptables服务是否正在运行
- 运行`status`命令查看规则是否正确设置
- 确认没有其他iptables规则优先于我们设置的规则

### 重启后规则丢失
- 检查systemd服务是否已正确创建和启用：
  ```bash
  systemctl status china-ip-access.service
  ```
- 如服务未启用，可手动启用：
  ```bash
  systemctl enable china-ip-access.service
  ```


脚本下载地址：[蓝奏云密码:8hsw](https://wwwo.lanzouq.com/b0j0z0zdi)

限制服务器只能中国大陆IP访问控制脚本

# Windows客户端内网穿透工具frp设置开机自启动


## 设置步骤

### 1. 设置frps自启动

自启动的脚本如下：

```vbs
Set ws = CreateObject("Wscript.Shell")
ws.run "cmd /c c:\frps\frps.exe -c c:\frps\frps.ini",vbhide
```

保存为 `frps.vbs`

### 2. 设置frpc自启动

自启动脚本如下：

```vbs
Set ws = CreateObject("Wscript.Shell") 
ws.run "cmd /c c:\frpc\frpc.exe -c c:\frpc\frpc.ini",vbhide
```

### 3. 放置启动文件

然后把vbs文件放到启动目录即可：

```
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp
```
