# 新到手的 Linux 服务器，我这样设置


目录

  * 概要
  * 重装系统
    * 选择脚本
    * 下载脚本
    * 执行脚本
  * 安装常用软件包
    * 基本工具包
    * 安装 Docker
    * 安装 Nginx
  * SSH 基本加固
  * 配置 Fail2ban
    * 安装 Fail2ban
    * SSH 守护配置
    * 启动 Fail2ban
    * 检查配置
  * 配置 UFW 防火墙
    * 安装 ufw
    * 设置默认策略
    * Cloudflare 回源访问规则
    * 启动 ufw 服务
    * 检查 ufw 规则
    * 计划任务
  * 防止 Docker 在 UFW 上打洞


## 概要#

本文介绍每次上手一台新的 Linux 服务器后，我的一些 **基本设置步骤** ，包括：

  * 使用一键 DD 脚本重装纯净的 Debian GNU/Linux 操作系统
  * SSH 安全和 Fail2ban 设置
  * 配置 UFW 防火墙
  * 安装 Nginx Web 服务器
  * 安装 Docker CE 及必要插件
  * 使用 Cloudflare CDN 保护服务和全球加速



并不一定适合所有人的需求，仅作为我每次快速设置新服务器的速查手册。




## 重装系统#

### 选择脚本#

网络上支持一键 DD 重装系统的脚本有很多，我主要使用这两个：

  1. [bin456789/reinstall](https://github.com/bin456789/reinstall)
  2. [bohanwood/debi](https://github.com/bohanwood/debi)



前者支持的系统选择更多，后者则专注于 Debian GNU/Linux 的最小发行版。两者都在 GitHub 上开源，且经过长期的社区关注和审查，安全性大可以放心。

无论如何，在正式开始之前，仔细阅读一遍脚本作者的说明（文档说明详细易读），知道自己在做什么，预期会出现什么。

我在所有服务器上都一直使用 Debian，下面以 debi 脚本为例。

### 下载脚本#
    
    
    curl -fLO https://raw.githubusercontent.com/bohanyang/debi/master/debi.sh
    

### 执行脚本#

赋予脚本可执行权限
    
    
    chmod +x debi.sh
    

开始重装系统
    
    
    sudo ./debi.sh \
      --version 13 \
      --architecture arm64 \
      --cloudflare \
      --user viamoe \
      --authorized-keys-url https://github.com/githubUserName.keys \
      --ssh-port 22122 \
      --bbr
    

**上面参数的意义：**

  * `--version 13`

指定 Debian 13（代号 `Trixie`）为安装的版本

  * `--architecture arm64`

指定系统架构，这里的 `arm64`，只适用于 ARM64 架构的机器（比如甲骨文 ARM VPS）

  * `--cloudflare`

使用 Cloudflare 作为系统默认 DNS

  * `--user viamoe`

创建一个普通用户，用户名为 `viamoe`，脚本自动配置该用户的 sudo 权限

  * `--authorized-keys-url https://github.com/githubUserName.keys`

指定 SSH 公钥 URL 来源，用于设置 SSH 免密码登录

  * `--ssh-port 22122`

修改 SSH 默认端口为 22122，你应当修改它，减少被自动扫描攻击的风险

  * `--bbr`

启用 BBR（TCP 拥塞控制算法），提升网络在高延迟或跨国网络环境下传输性能




一切就绪，开始重装系统
    
    
    sudo reboot
    

期间你可以使用 VNC 查看系统安装进度，根据服务器性能或网络环境，稍等几分钟，新的系统即将就绪。之后，使用重装阶段预设的用户名密码或 SSH 密钥登录服务器。

## 安装常用软件包#

我们的服务器正在运行的是一个纯净、最小、最新的 Debian GNU/Linux 操作系统，需要安装一些基础或常用的软件包。

### 基本工具包#
    
    
    sudo apt update
    sudo apt install \
        ca-certificates \
        apt-transport-https \
        man \
        build-essential \
        git \
        curl \
        wget \
        unzip \
        screen \
        btop \
        net-tools \
        tree \
        neovim
    

### 安装 Docker#

参考 Docker [官方文档](https://docs.docker.com/engine/install/debian/) 说明的步骤，下列命令不保证时效性
    
    
    # Add Docker's official GPG key:
    sudo apt-get update
    sudo apt-get install ca-certificates curl
    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc
    
    # Add the repository to Apt sources:
    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
      $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
      sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    sudo apt-get update
    
    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    sudo systemctl status docker
    

### 安装 Nginx#

同样地，参考 Nginx 项目文档——在 Debian 上的 [安装步骤](https://nginx.org/en/linux_packages.html#Debian)
    
    
    # install the prerequisites
    sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring
    
    # import gpg key
    curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
        | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
        
    # verify gpg key
    mkdir -m 700 ~/.gnupg
    gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
    
    echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
    http://nginx.org/packages/debian `lsb_release -cs` nginx" \
        | sudo tee /etc/apt/sources.list.d/nginx.list
    
    # install nginx
    sudo apt update
    sudo apt install nginx
    
    # start nginx
    sudo systemctl start nginx
    

## SSH 基本加固#

编辑 SSH 配置文件
    
    
    sudo nvim /etc/ssh/sshd_config
    

这里有一些我们需要关注的配置项目：

  * `Port 22122`

SSH 服务监听的默认端口，我们已在重装脚本中指定

  * `PermitRootLogin no`

禁止 Root 用户直接登录，使用普通用户登录，使用 sudo 提权

  * `PasswordAuthentication no`

禁止使用密码登录 SSH，我们应当使用密钥对或实体安全密钥（如 Yubikey、Canokey 等）进行登

  * `PermitEmptyPasswords no` 禁止空密码登录

  * `ChallengeResponseAuthentication no` 禁用键盘交互式密码认证

  * `PubkeyAuthentication yes` 启用公钥认证，此前已在重装脚本中指定

  * `UseDNS no` 禁用 DNS 反查

  * `X11Forwarding no` 禁用 X11 转发，如果你不知道这是什么那就可以禁用




保持当前的 SSH 会话不要断开连接，重启 SSH 服务
    
    
    sudo systemctl restart sshd
    

重开一个 SSH 会话，再次登录当前服务器，确保连接正常，否则返回第一个 SSH 会话中进行检查。

## 配置 Fail2ban#

使用 Fail2ban 保护我们的服务器免受 SSH 爆破，并合理封禁异常的 IP 地址

### 安装 Fail2ban#
    
    
    sudo apt update
    sudo apt install fail2ban
    

### SSH 守护配置#

创建一个最小的，仅用于守护 SSH 登录的 Fail2ban 配置文件
    
    
    sudo nvim /etc/fail2ban/jail.local
    

配置内容如下：
    
    
    [DEFAULT]
    # 忽略 IP 地址：防止将自己封禁。
    # 如果您使用动态 IP，不要设置您的公网 IP。
    # 127.0.0.1/8 和 ::1 忽略本地回环地址。
    ignoreip = 127.0.0.1/8 ::1
    
    # 封禁时间：封禁 1 小时（3600 秒）
    bantime  = 1h
    
    # 查找时间：在 10 分钟内（600 秒）
    findtime = 10m
    
    # 最大重试次数：如果在 findtime (10 分钟) 内失败了 3 次，则封禁。
    maxretry = 3
    
    [sshd]
    # 启用 SSH 保护
    enabled = true
    
    # SSH 服务的监听端口：确保这里设置为您的自定义端口 22122
    port    = 22122
    
    # 日志文件路径：Debian/Ubuntu/CentOS 通常使用 auth.log，默认配置会自动检测。
    # logpath = /var/log/auth.log 
    # filter：使用默认的 sshd 过滤器（无需修改）
    # filter = sshd
    

### 启动 Fail2ban#
    
    
    sudo systemctl enable fail2ban
    sudo systemctl restart fail2ban
    

### 检查配置#
    
    
    sudo fail2ban-client status sshd
    sudo fail2ban-client status
    

如果输出显示 `Jail status: ... Status: running`，在 `Jail list` 中看到了 `sshd`，应该就配置成功了。

## 配置 UFW 防火墙#

### 安装 ufw#
    
    
    sudo apt install ufw
    

### 设置默认策略#

默认拒绝所有传入/入站连接
    
    
    sudo ufw default deny incoming
    

默认允许所有传出/出站连接
    
    
    sudo ufw default allow outgoing
    

现在大多数服务器有 IPv6 公网 IP，启用 IPv6 支持
    
    
    sudo sed -i 's/IPV6=no/IPV6=yes/' /etc/default/ufw
    

**允许 SSH 传入/入站连接**

> 千万不要忘记 SSH 端口，以免自己被「锁在」UFW 外面！
    
    
    # 替换为实际 SSH 端口
    sudo ufw allow 22122/tcp
    

### Cloudflare 回源访问规则#

Nginx 默认监听端口 80(HTTP) 和 443(HTTPS)，要允许 Cloudflare CDN 回源访问，必需将 Cloudflare IP 段添加到 UFW 白名单里。

新建一个 Cloudflare IPs 自动更新脚本
    
    
    sudo nvim /usr/local/bin/ufw-cf-whitelist
    

**该脚本用于：**

  * 移除之前旧的 Cloudflare IP 白名单规则
  * 获取 Cloudflare 最新的 IPv4 和 IPv6 列表
  * 允许列表中每个 IP 段访问 80/443 端口



脚本内容如下：
    
    
    #!/bin/bash
    
    # Cloudflare 官方 IP 列表
    IPV4_URL="https://www.cloudflare.com/ips-v4"
    IPV6_URL="https://www.cloudflare.com/ips-v6"
    
    echo "=== 1. 清除现有的 Cloudflare UFW 规则..."
    # 清除旧的规则（通过删除带有 "Cloudflare" 注释的规则）
    # 注意：UFW 不直接支持注释删除，所以这个步骤需要手动或使用更复杂的工具，
    # 这里我们采用简单的清理，如果规则不多，可以手动检查 `ufw status numbered`。
    # 更好的方法是在每次运行前删除所有 80/443 的 ALLOW 规则，但风险更高。
    
    # 暂时只删除明确的 Cloudflare 规则，以防万一
    # sudo ufw delete allow in on any to any port 80/tcp
    # sudo ufw delete allow in on any to any port 443/tcp
    
    
    echo "=== 2. 下载最新的 Cloudflare IP 范围列表..."
    # 使用 tempfile 确保下载的文件安全
    IPV4_TEMP=$(mktemp)
    IPV6_TEMP=$(mktemp)
    
    curl -s $IPV4_URL -o $IPV4_TEMP
    curl -s $IPV6_URL -o $IPV6_TEMP
    
    echo "=== 3. 添加 IPv4 规则 (80/443)..."
    while read ip; do
        if [[ ! -z "$ip" ]]; then
            sudo ufw allow proto tcp from $ip to any port 80 comment 'Cloudflare IPv4 HTTP'
            sudo ufw allow proto tcp from $ip to any port 443 comment 'Cloudflare IPv4 HTTPS'
        fi
    done < $IPV4_TEMP
    
    echo "=== 4. 添加 IPv6 规则 (80/443)..."
    while read ip; do
        if [[ ! -z "$ip" ]]; then
            sudo ufw allow proto tcp from $ip to any port 80 comment 'Cloudflare IPv6 HTTP'
            sudo ufw allow proto tcp from $ip to any port 443 comment 'Cloudflare IPv6 HTTPS'
        fi
    done < $IPV6_TEMP
    
    echo "=== 5. 清理临时文件..."
    rm $IPV4_TEMP $IPV6_TEMP
    
    echo "=== 6. 完成 Cloudflare 白名单配置。"
    ufw status numbered
    

赋予脚本可执行权限
    
    
    sudo chmod +x /usr/local/bin/ufw-cf-whitelist
    

执行脚本，更新 ufw 规则
    
    
    sudo ufw-cf-whitelist
    

### 启动 ufw 服务#
    
    
    sudo ufw enable
    sudo ufw reload
    

若是提示：
    
    
    Command may disrupt existing ssh connections. Proceed with operation (y|n)?
    

### 检查 ufw 规则#
    
    
    sudo ufw status numbered
    

### 计划任务#

实际上 Cloudflare IP 段几乎很少变动（最起码最近两年多完全没有变化），因此这个步骤不是必须的。使用 Crontab 计划：
    
    
    sudo crontab -e
    

比如每天凌晨 3 点执行一次
    
    
    0 3 * * * /usr/local/bin/ufw-cf-whitelist.sh > /dev/null 2>&1
    

## 防止 Docker 在 UFW 上打洞#



这个 `check-if-docker-break-ufw.sh` 脚本用于检查是否出现了这种情况
    
    
    #!/usr/bin/env bash
    # ===============================================================
    # check-docker-ports.sh
    # 检查 Docker 容器端口暴露与 UFW 状态
    # ===============================================================
    
    RED="\033[0;31m"
    GREEN="\033[0;32m"
    YELLOW="\033[1;33m"
    RESET="\033[0m"
    
    echo "🔍 正在检查 Docker 端口暴露情况..."
    echo "=============================================================="
    
    # 获取 docker ps 输出
    docker_ps=$(docker ps --format '{{.Names}}|{{.Ports}}')
    
    if [ -z "$docker_ps" ]; then
      echo "❌ 没有正在运行的容器。"
      exit 0
    fi
    
    printf "%-25s %-25s %-20s\n" "容器名" "绑定地址" "状态"
    echo "--------------------------------------------------------------"
    
    while IFS='|' read -r name ports; do
      if [[ -z "$ports" ]]; then
        printf "%-25s %-25s ${GREEN}%-20s${RESET}\n" "$name" "无对外端口" "安全"
        continue
      fi
    
      # 分析每个映射
      for port in $(echo "$ports" | tr ',' '\n'); do
        port=$(echo "$port" | sed 's/ //g')
    
        if [[ "$port" =~ 0\.0\.0\.0 ]]; then
          printf "%-25s %-25s ${RED}%-20s${RESET}\n" "$name" "$port" "⚠️ 公网暴露"
        elif [[ "$port" =~ 127\.0\.0\.1 ]]; then
          printf "%-25s %-25s ${GREEN}%-20s${RESET}\n" "$name" "$port" "本机安全"
        else
          printf "%-25s %-25s ${YELLOW}%-20s${RESET}\n" "$name" "$port" "内部网络"
        fi
      done
    done <<< "$docker_ps"
    
    echo "--------------------------------------------------------------"
    echo "🧱 检查宿主机端口监听状态..."
    ss -tlnp | grep -E 'docker|LISTEN' | awk '{print $4, $6}' | sed 's/users://g' | sed 's/"//g' | sed 's/,//g' | sed 's/\[::\]://g'
    echo "--------------------------------------------------------------"
    
    echo "🧩 检查 UFW 规则..."
    sudo ufw status numbered
    
    echo "=============================================================="
    echo "✅ 检查完成。绿色=安全，黄色=内部安全，红色=公网暴露。"
    

最简单的方式，不要将任何 Docker 容器的端口绑定到 `0.0.0.0` 上，只需将暴露端口绑定到 `127.0.0.1` 上即可。

（完）




新到手的 Linux 服务器，我这样设置

# 直播录制工具
###### -所有代码由AI创建，本人只负责测试工作

开发原由：大晚上的比赛不想熬夜观看，在飞牛中部署脚本，晚上定时录制，第二天上班摸鱼观看。

功能：用于录制 m3u8 格式的直播流，支持自定义开始时间、结束时间和分段时长。


## ⚠️ 使用前必读


主要需要修改：
- `直播链接.txt` - 将示例URL替换为您的实际直播源地址
- `docker/env.example` 或 `docker/.env` - Docker版本的环境变量配置（可选）

## 📦 两种版本

本项目提供两种运行方式：

1. **直接运行版本** - 直接在系统上运行 Python 脚本（当前目录）
2. **Docker 版本** - 使用 Docker Compose 运行（`docker/` 目录）


## 功能特点

- ✅ 支持自定义开始录制时间（适合凌晨开始的比赛）
- ✅ 支持自定义结束录制时间
- ✅ 支持自定义分段时长（避免长时间录制出错）
- ✅ **支持多条链接同时并行录制**（在 `直播链接.txt` 中每行一个URL）
- ✅ 自动分段保存，每个分段独立文件
- ✅ 文件名包含时间戳和分段编号
- ✅ 多条链接时，每个链接的文件保存在独立子目录中

## 系统要求

- Debian/Linux 系统
- Python 3.6+
- ffmpeg

## 安装依赖

```bash
# 安装 ffmpeg
sudo apt-get update
sudo apt-get install -y ffmpeg

# 安装 Python（如果还没有）
sudo apt-get install -y python3 python3-pip
```

## 使用方法

### 1. 基本使用（立即开始，手动停止）

```bash
python3 record_live.py --segment 5
```

### 2. 指定开始和结束时间

```bash
# 23:30 开始，02:00 结束（跨天），每10分钟一段
python3 record_live.py --start 23:30 --end 02:00 --segment 10
```

### 3. 只指定开始时间（录制到手动停止）

```bash
python3 record_live.py --start 23:30 --segment 10
```

### 4. 使用自定义URL

```bash
# ⚠️ 请将 example.com 替换为您的实际直播源地址
python3 record_live.py --url https://example.com/live/stream.m3u8 --start 23:30 --end 02:00 --segment 5
```

## 参数说明

- `--url`: 直播流URL（可选，如果不提供会从 `直播链接.txt` 读取）
- `--start`: 开始时间，格式 `HH:MM` 或 `HH:MM:SS`（如：`23:30`）
- `--end`: 结束时间，格式 `HH:MM` 或 `HH:MM:SS`（如：`02:00`）
- `--segment`: 每个分段的分钟数（默认：10分钟）

## 输出文件

录制文件保存在 `data/` 目录下：

**单条链接时：**
```
data/
  └── YYYYMMDD_HHMMSS_segment_001.mp4
      YYYYMMDD_HHMMSS_segment_002.mp4
      ...
```

**多条链接时（每条链接独立子目录）：**
```
data/
  ├── stream_01_example/      # 第1条链接的录制文件
  │   ├── YYYYMMDD_HHMMSS_segment_001.mp4
  │   └── YYYYMMDD_HHMMSS_segment_002.mp4
  └── stream_02_example/      # 第2条链接的录制文件
      ├── YYYYMMDD_HHMMSS_segment_001.mp4
      └── YYYYMMDD_HHMMSS_segment_002.mp4
```

## 多条链接支持

在 `直播链接.txt` 文件中，可以添加多个URL，每行一个：

```
# ⚠️ 请将下面的示例URL替换为您的实际直播源地址
https://example.com/live/stream1.m3u8
https://example.com/live/stream2.m3u8
https://example.com/live/stream3.m3u8
```

脚本会自动检测所有链接，并**同时并行录制**所有链接。每条链接的文件会保存在独立的子目录中，方便管理。

**注意：** 以 `#` 开头的行会被忽略（可以作为注释）。

## 示例场景

### 场景1：凌晨比赛录制
比赛在 00:30 开始，预计 03:00 结束，每5分钟一段：

```bash
python3 record_live.py --start 00:30 --end 03:00 --segment 5
```

### 场景2：晚上比赛录制
比赛在 20:00 开始，预计 22:30 结束，每10分钟一段：

```bash
python3 record_live.py --start 20:00 --end 22:30 --segment 10
```

## 注意事项

1. 确保网络连接稳定
2. 确保有足够的磁盘空间
3. 如果录制时间跨越午夜，结束时间会自动识别为第二天
4. 可以随时按 `Ctrl+C` 手动停止录制
5. 如果某个分段录制失败，会自动跳过并继续下一个分段

## 后台运行

如果需要后台运行，可以使用 `nohup` 或 `screen`：

```bash
# 使用 nohup
nohup python3 record_live.py --start 23:30 --end 02:00 --segment 10 > record.log 2>&1 &

# 或使用 screen
screen -S record
python3 record_live.py --start 23:30 --end 02:00 --segment 10
# 按 Ctrl+A 然后 D 分离会话
# 重新连接: screen -r record
```

---

## 🐳 Docker 版本

如果需要使用 Docker 版本，请查看 `docker/` 目录：

```bash
cd docker
docker compose up -d
```

详细文档请参考：[docker/README.md](docker/README.md)

---

## 📊 存储空间计算

根据测试数据（1分钟 = 24MB）：
- **1 小时 = 1.44 GB**
- **2 小时 = 2.88 GB**
- **3 小时 = 4.32 GB**

建议预留至少 **5-10 GB** 空间用于录制。

---

## 💡 版本选择建议

### 选择 Docker 版本，如果：
- ✅ 想要环境隔离，不污染系统
- ✅ 需要在多台机器上部署
- ✅ 希望一键启动，简化部署流程
- ✅ 需要自动重启和日志管理
- ✅ 系统环境比较复杂，避免依赖冲突
- ✅ 使用飞牛 NAS 等容器化平台

### 选择直接运行版本，如果：
- ✅ 资源有限，希望最小化开销
- ✅ 需要频繁调试和修改代码
- ✅ 已有完善的系统环境和工具链
- ✅ 希望与系统服务深度集成（如 systemd）
- ✅ 对 Docker 不熟悉或不想使用容器

**对于飞牛 NAS 用户，推荐使用 Docker 版本**，因为飞牛 NAS 本身就是基于容器的平台，Docker 版本可以更好地与系统集成。

脚本地址：[蓝奏云](https://wwwo.lanzouq.com/iDD5x3ab5wjg)



直播录制

# 使用screen来实现多任务不断线操作命令


## 说明

我们用VPS执行一个系统安装，就输入命令然后在那一直等。如果出现掉线或者断网死机的情况，我们还得重新安装。如果能使用上`screen`命令可以实现无人值守的效果。我们可以同时操作多个任务，也可以关机操作。所以说很方便。

## 方法

### 1、安装方法

```bash
yum install screen  #CentOS
apt-get install screen  #Debian或者Ubuntu
```

### 2、创建一个screen会话

```bash
screen -S xx  #xx为创建会话的名称
```

### 3、隐藏并保留当前会话窗口

```
按Ctrl+A，再按"D"键
```

如果怕中途掉线或者要离开的话，可以使用。

### 4、恢复会话窗口

```bash
screen -r xx #恢复名字为xx的会话
```

如果在恢复会话的时候忘记了或者没有设定会话名称我们就要执行：

```bash
screen -ls
```

他会列出你所有的会话列表，然后使用：

```bash
screen -r 会话名称
```

来恢复会话窗口。

### 5、关闭会话窗口

```bash
exit
```

`screen`的好处就是不会因为远程的操作因网络问题中断掉。





使用screen来实现多任务不断线操作命令

项目地址：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)

