#iPerf3 分布式网络测试工具全攻略：从安装到进阶监控

#项目简介

iPerf3 分布式网络测试工具 是一款基于 Python 开发的轻量级分布式网络监控套件。它通过 Master（主控） 与 Agent（代理） 的协同配合，实现了跨节点的带宽测试（iPerf3）、延迟监控（Ping）和路由追踪（Traceroute）可视化分析。

#核心亮点

#系统架构

项目采用解耦的分布式架构设计。主控节点负责数据持久化、任务调度与 Web 展示；代理节点则专注于执行网络探测任务并回传结果。

#组件技术栈

#环境准备

在开始部署前，请确保您的服务器满足以下条件：

#系统要求

• 操作系统：Ubuntu 20.04+、Debian 11+、CentOS 7+ 或其他主流 Linux 发行版
• 硬件配置：至少 1 核 CPU / 512MB 内存（建议 2 核 / 1GB 以获得更好体验）
• 基础依赖：已安装 Docker、Docker Compose 和 Git

#网络端口

请确保以下端口在防火墙和安全组中已开放：

#快速部署

#安装主控节点 (Master)

主控节点包含数据库、缓存和管理后台，是整个系统的核心枢纽。

步骤 1：克隆项目仓库

git clone https://github.com/podcctv/iperf3-test-tools.git
cd iperf3-test-tools

步骤 2：执行一键安装脚本

bash ./update_iperf3_master.sh

安装过程中，脚本会自动完成以下工作：

• 拉取并构建 Docker 镜像
• 初始化 PostgreSQL 数据库
• 生成随机管理员密码
• 启动所有服务容器

步骤 3：访问仪表盘

安装完成后，访问以下地址进入管理面板：

http://<服务器 IP>:9100/web

#安装代理节点 (Agent)

代理节点只需运行一条脚本即可完成自动注册。

curl -sSL https://raw.githubusercontent.com/podcctv/iperf3-test-tools/main/install_agent.sh | bash -s -- \
  --master-url http://<Master-IP>:9000 \
  --node-name "香港 BGP 节点"

参数说明：

安装完成后，新节点会自动出现在主控仪表盘的节点列表中。

#核心功能详解

#节点监控仪表盘

仪表盘首页提供全方位的节点状态概览：

• 节点状态卡片：实时显示在线/离线状态，在线节点有呼吸动效
• 三网延迟：同时监测电信、联通、移动三大运营商的连接延迟
• Ping 趋势图：通过 Sparkline 迷你图展示 24 小时延迟波动曲线
• 流媒体检测徽章：自动识别 Netflix、Disney+、ChatGPT 等服务的解锁状态，并显示区域角标（如 HK / US / SG）

#可视化路由追踪 (Metro-line)

该工具将复杂的 Traceroute 数据转化为类似"地铁线路图"的可视化界面：

核心功能：

• AS 路径分析：清晰展示数据包经过的自治系统（AS 编号及名称）
• 延迟胶囊徽章：根据延迟自动着色（绿色 < 50ms / 黄色 < 150ms / 红色 > 150ms）
• ISP/IX 徽章识别：自动识别 CN2、9929、NTT 等优质线路
• 智能变化告警：当路由节点发生变化时，系统通过 Telegram 推送高亮对比差异

#定时任务调度

您可以设置周期性的 iPerf3 测试任务，系统将自动记录并分析：

• 上下行带宽：支持 TCP / UDP 双模式测试
• 并行连接数：可配置同时建立的连接数量
• 趋势图表：24 小时内的带宽波动曲线
• 流量统计：展示节点日消耗流量，适合管理有流量配额的 VPS

#Telegram 智能通知

配置 Telegram Bot 后，系统可自动推送以下事件：

• 📡 路由变化告警（附带跳点差异对比）
• ⚠️ 定时任务执行失败通知
• 🔴 节点离线告警

#配置参考

#环境变量

#Docker Compose 示例

# docker-compose.yml
services:
  master-api:
    build: ./master-api
    ports:
      - "9000:9000"
    depends_on:
      - db
      - redis
    environment:
      - DATABASE_URL=postgresql://iperf:iperf_pass@db:5432/iperf_db
      - REDIS_URL=redis://redis:6379

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: iperf
      POSTGRES_PASSWORD: iperf_pass
      POSTGRES_DB: iperf_db

  redis:
    image: redis:7-alpine

#API 接口一览

#核心接口

#路由追踪接口

#Telegram 配置接口

#更新与维护

#常规版本升级

在 Master 节点执行以下命令进行版本升级：

cd iperf3-test-tools
git pull origin main
docker compose build --no-cache master-api
docker compose up -d

#Agent 自动更新

Agent 节点支持 Watchdog 自动更新机制。运行以下脚本开启自动同步：

curl -sSL https://raw.githubusercontent.com/podcctv/iperf3-test-tools/main/setup-agent-autoupdate.sh | sudo bash

启用后，当 Master 版本升级时，Agent 会自动检测并完成更新。

#故障排查

#常见问题速查表

#密码重置命令

docker compose exec master-api python -m app.auth --set-password 'YourNewPassword' --force

#强制重建容器

docker compose down
docker compose up -d --build --force-recreate

#结语

iPerf3 分布式网络测试工具通过极简的部署流程和强大的可视化分析能力，为多机房网络性能管理提供了高效的解决方案。无论是日常的带宽监控、路由追踪分析，还是跨节点的网络质量对比，该工具都能满足您的需求。

如有任何问题或建议，欢迎前往 GitHub 仓库 提交 Issue 或参与贡献！

#参考链接

• GitHub 仓库
• 在线 API 文档：部署完成后访问 http://your-ip:9000/docs
• 问题反馈

#PVE 安装切 KVM 虚拟机以及基于 NAT 实现独立双栈 IP

#准备

• 大鸡一台
• 一个人
• 一双手
• 一键盘

#安装 PVE

#DD 重装系统

首先，进入 SSH，重装一下系统，这里使用 bin456789/reinstall 的 DD 重装脚本。

curl -O https://raw.githubusercontent.com/bin456789/reinstall/main/reinstall.sh || wget -O ${_##*/} $_
bash reinstall.sh debian 12 --password 这里填写你的root密码 --ssh-key "这里填写你的ssh公钥ID (没有可不填)"

#安装基本包

apt update
apt install curl sudo wget -y

#安装 PVE

1. 使用oneclickvirt的install_pve.sh一键安装 PVE 脚本

curl -L https://raw.githubusercontent.com/oneclickvirt/pve/main/scripts/install_pve.sh -o install_pve.sh && chmod +x install_pve.sh && bash install_pve.sh

2. 安装直到显示以下对话：

Please execute reboot to reboot the system and then execute this script again
Please wait for at least 20 seconds without automatically rebooting the system before executing this script.
请执行 reboot 重启系统后再次执行本脚本，再次使用SSH登录后请等待至少20秒未自动重启系统再执行本脚本

3. 如文本所示，这时候只需要reboot重启，然后再次连接等待 20s 后再执行一次脚本

bash install_pve.sh

4. 然后会要求输入新主机名字：

Please enter a new host name (can only contain English letters and numbers, not pure numbers or special characters, enter the default pve):
请输入新的主机名(只能包含英文字母和数字,不能是纯数字或特殊字符,回车默认为pve):

不修改默认回车就好。 然后等待安装完成。

5. 当显示如下信息则已经安装完成：

Running kernel: pve-manager/8.4.14/b502d23c55afcba1 (running kernel: 6.1.0-41-cloud-amd64)

Installation complete, please open HTTPS web page https://123.123.123.123:8006/
The username and password are the username and password used by the server (e.g. root and root user's password)
If the login is correct please do not rush to reboot the system, go to execute the commands of the pre-configured environment and then reboot the system
If there is a problem logging in the web side is not up(Referring to the page reporting an error, it keeps loading or is normal), wait 10 seconds and restart the system to see

安装完毕，请打开HTTPS网页 https://123.123.123.123:8006/
用户名、密码就是服务器所使用的用户名、密码(如root和root用户的密码)

如果登录无误请不要急着重启系统，去执行预配置环境的命令后再重启系统
如果登录有问题web端没起来(指的是网页报错，一直在加载还是正常的)，等待10秒后重启系统看看

这时候就去访问信息中的链接地址就可以访问到 PVE 后台了，用户名是root，密码则是你ssh的root密码。

#配置 PVE 宿主机的网络

[!警告] 确定能够进入 PVE 之后，再进行此操作。

使用一键脚本进行配置：

bash <(wget -qO- --no-check-certificate https://raw.githubusercontent.com/oneclickvirt/pve/main/scripts/build_nat_network.sh)

然后就会自动创建brige网络接口。 vmbr0负责 v4 的独立 IP，vmbr1负责复杂 v4/v6 的 NAT，vmbr2负责 v6 的独立 IP

#分 KVM 虚拟机

1. 首先，先下镜像，这里直接用 Debian 的官方镜像，传送门 这里使用debian-12-genericcloud-amd64.qcow2作为小鸡的系统。 先下载到 PVE 上：

wget https://cdimage.debian.org/cdimage/cloud/bookworm/latest/debian-12-genericcloud-amd64.qcow2

2. 接下来去创建虚拟机，填写虚拟机名称，然后操作系统选择不使用任何介质：

系统默认即可

磁盘 删除掉默认的硬盘，不需要添加硬盘：

CPU根据需要选择，类别如需要高性能可选择host否则默认即可：

内存根据需要给就行：

网络如果有多个独立 IPV4 选择vmbr0，如果使用 NAT，选择vmbr1：

然后创建即可。

3. 然后进入 PVE 控制台，将镜像导入到该虚拟机中：

qm disk import 100 debian-12-genericcloud-amd64.qcow2 local --format qcow2

100是虚拟机 ID debian-12-genericcloud-amd64.qcow2是镜像 local是本地存储

4. 导入之后，进入虚拟机的硬件，找到未使用的硬盘0，双击或者点编辑，然后添加硬盘，总线/设备可选VirtIO Block：

5. 然后再选择硬盘，然后点击磁盘操作-调整大小，输入要增大硬盘的大小：

6. 然后再点选项，双击引导顺序，将virtio0硬盘启用，然后拉到第一位：

7. 再回到硬件，点击添加，选择Cloudinit 设备，然后添加：

8. 然后点击Cloud-Init，然后可以设置用户、密码、SSH公钥、DNS服务器、IP设置 按需设置，这里还需要讲清楚IP设置，NAT4 需要为虚拟机设置固定的内网 IP：

这里因为我要给虚拟机设置独立 IPV6，就不需要设置 NAT6 了，如果需要设置 NAT6，就给它设置 NAT 的子网段，例如：

9. 然后再回到硬件，添加串行接口：

10. 然后选中显示，显卡换成串行终端 0：

11. 然后就可以正常开机，享受刚切的小鸡鸡了。

#给 KVM 虚拟机添加独立 IPV6

1. 在虚拟机硬件中点击添加网络设备：

2. 然后回到Cloud-Init中，编辑IP配置(net1)，设置静态的 IPV6：

3. 进入虚拟机，使用ip.sb测试 IPV4 和 IPV6 是否正常：

curl ip.sb -4
curl ip.sb -6

#开启 ROOT 密码登录

1. 进入虚拟机的控制台，然后输入用户名和密码进行登录

2. 编辑/etc/ssh/sshd_config文件

nano /etc/ssh/sshd_config

找到PermitRootLogin和PasswordAuthentication，去掉注释改成：

PermitRootLogin yes
PasswordAuthentication yes

然后按Ctrl+X，按 Y 确认然后回车保存，然后再重启 ssh 服务：

systemctl restart sshd

#NAT 端口转发

1. 使用iptables宿主机上的端口转发到虚拟机的端口上

iptables -t nat -A PREROUTING -i vmbr0 -p tcp --dport 10000 -j DNAT --to-destination 172.16.1.2:22

dport 宿主机端口 to-destination 虚拟机地址端口

2. 永久保存方法： 编辑/etc/network/interfaces 在iface vmbr1 inet static后面添加上

post-up iptables -t nat -A PREROUTING -i vmbr0 -p tcp --dport 10000 -j DNAT --to-destination 172.16.1.2:22
post-dodwn iptables -t nat -D PREROUTING -i vmbr0 -p tcp --dport 10000 -j DNAT --to-destination 172.16.1.2:22

保存即可，然后重启网络：

systemctl restart networking

#使用 Squashfs 进行服务器数据备份——从为什么，到怎么做

数据无价。 在现代服务器运维中，数据备份是每一位用户的必修课。如果服务器上承载着不可复现的珍贵数据，那么即便只有万分之一的可能，您也必须为天灾、人祸、乃至「物理上云」的最坏情况做好准备。

而无论是执行备份还是服务迁移，选择一种高效的归档格式都至关重要。与使用 rsync 等工具处理海量的零散文件相比，单个归档文件在管理和传输上显然更为便捷高效。
本文将详细介绍如何使用 Squashfs 工具，来实现服务器数据的高效归档与备份。

#为什么选择 Squashfs？

Squashfs 可能对于 Linux 高手来说已经并不陌生，但是对于大多数平常在用 Windows 的用户而言，当提到压缩与归档格式的时候，第一反应往往是 zip、7z 或者 zip 这一类常见格式。因此在正式开工之前，请允许我使用比较大的篇幅来介绍一下，我们为什么要选择 Squashfs 格式。

我们首先理清一下我们的需求：

• 我们想要对服务器的数据进行备份，而且在我们需要的时候原样恢复回去。
• 我们希望备份文件尽可能小，以节省存储空间和传输时间。
• 我们希望备份和恢复的过程尽可能简单高效。
• 虽然对于备份数据而言一般都是冷备份（除非真的发生故障，否则一般都不会去访问），但有时又想从里面拿出一点东西来用。

如果你认为如上需求和你的备份理念相符，那么恭喜你 —— Squashfs 很可能是一个非常适合你的选择。

Squashfs 是一款专为 Linux 设计，随 Linux 而生的只读压缩文件系统。它于 Linux 2.6.29 内核中被正式引入主线，并在 Linux 4.14 之后进一步完善成现在的样子。现在这个格式已经被广泛应用于各种 Linux 发行版的 Live CD、嵌入式系统（如 OpenWrt）以及容器镜像中。
Squashfs 之所以适合备份，有以下几个原因：

• 高压缩比：Squashfs 支持 Gzip、LZMA、LZO、LZ4、XZ 和 Zstd 等多种压缩算法，可以根据需求选择合适的压缩方式，从而在压缩率和速度之间取得平衡。除此之外，Squashfs 块级压缩的特性还方便了重复数据的去重，从而进一步提升压缩效果。
• 只读特性：作为只读文件系统（可以通过 OverlayFS 等方式来实现读写，但是对于备份数据而言超纲了），Squashfs 可以保证备份数据的一致性。而且尤其需要强调的是，Squashfs 能够做到在创建归档文件的同时完整保留文件的元数据（包括权限、时间戳、符号链接等），最大限度保持原样，这对于服务器数据的备份和恢复尤为重要。
• 随机访问：Squashfs 支持通过 mount 挂载的方式直接随机访问文件，这意味着即使在一个大型的归档文件中，也可以快速定位并提取单个文件，而不需要解压整个归档。
• 支持广泛：作为随 Linux 内核成长的文件系统，Squashfs 在 Linux 中能够做到不额外安装任何软件即可通过内核挂载读取数据，而在 Windows 等平台上，你也可以通过第三方工具（如 7-Zip 及其衍生）来访问 Squashfs 文件。

接下来我们将 Squashfs 与常见的归档格式进行对比：

• tar 和他的动物朋友们：tar 本身属于流式归档，并不具备压缩功能。通常需要配合 gzip、bzip2、xz 等压缩工具使用。但是压缩后的文件格式不支持随机访问，需要解压整个归档才能访问其中的文件。
• 7z / zip / rar：这三个都是 Windows 上非常流行的压缩格式，但是和 POSIX 系统下的 Linux 生态相比，显得相当水土不服——这些格式都无法完整保留 Linux 文件的元数据（尤其是权限和链接），这对于服务器核心数据的备份来说是不可接受的。此外，可以认为这些格式的随机访问能力和他们的数据去重能力不可兼得：标准 ZIP 格式不支持数据去重，而 7z 和 RAR 格式启用了固实压缩后就失去了随机访问能力。

#创建归档

虽然 Squashfs 可以在现代 Linux 内核中直接挂载使用，但是创建 Squashfs 归档文件则需要借助 mksquashfs 工具。这个工具通常包含在 squashfs-tools 软件包中，可以通过包管理器安装：

sudo apt update && sudo apt install squashfs-tools

mksquashfs 的基本用法非常简单，你如果想快速创建一个 Squashfs 归档文件，只需要指定源目录和目标文件名即可：

# 备份 /etc 目录到 etc.squashfs
mksquashfs /etc etc.squashfs

通过查看 manpage ，我们可以知道：在 Debian 13 中如果不加任何参数，mksquashfs 会使用 gzip 进行 9 级压缩，默认分块大小为 128KB，并且保留所有文件扩展元数据。

在归档完成后，mksquashfs 会输出一大串信息，详细给出包括重复文件数、符号链接与硬连接数、块大小、乃至 uid 和 gid 个数等信息，十分详细：

而对于这里的冷备份需求，我们可以牺牲一点时间来换取更高的压缩比，你可以在如上的 manpage 中找到更多可选参数（注意对于一些老 Linux 版本，通常不支持使用一些比较新的压缩算法）。
通常而言，对于归档需求，我会建议换成比 gzip 压缩表现更好的 zstd 算法，把压缩比拉到最高的 22，然后把块大小调大到 mksquashfs 支持的最大值 1M（压缩表现更好，但是会牺牲一些随机读取性能），同时显性要求保留元数据，反映在命令上就是这样：

mksquashfs /etc etc.squashfs -xattrs -comp zstd -Xcompression-level 22 -b 1M

特别的，如果你想要排除掉目录里的某些文件或子目录，可以使用 -e 参数指定排除列表。例如，下面的命令会排除 /etc 目录下的 shadow 和 passwd 文件：

mksquashfs /etc etc.squashfs -xattrs -comp zstd -Xcompression-level 22 -b 1M -e shadow passwd

#解压与管理归档

创建好的 Squashfs 归档文件可以通过多种方式进行解压和管理。如果你只是想要对归档文件进行管理，最常见的方法是使用 unsquashfs 工具，它同样包含在 squashfs-tools 软件包中。

你同样可以在 manpage 中找到 unsquashfs 的使用说明，如下仅介绍一些常见的用法：

#列出归档内容（不解压）

使用 -l (list) 选项：

unsquashfs -l etc.squashfs

它会像 ls -R 命令一样，递归地列出镜像中的所有文件、权限和目录结构。

如果你想像 ls -lR 一样显示文件权限与所有者，请使用 -ll 选项：

你可以在后面追加路径参数，来限制只列出某个子目录下的内容，例如：

unsquashfs -ll etc.squashfs alternatives/

#解压归档内容

使用 -d (destination) 选项指定解压目录：

mkdir ./etc_backup
unsquashfs -d ./etc_backup etc.squashfs

你也可以只解压归档中的某个子目录或文件，例如：

unsquashfs -d ./alternatives_backup etc.squashfs alternatives/

#直接挂载

解压并不是 SquashFS 的主要用法。它真正的强大之处在于直接挂载，无需解压即可访问。 你可以使用 mount 命令将 Squashfs 归档文件挂载到一个目录中：

mkdir /mnt/etc
sudo mount -o loop etc.squashfs /mnt/etc

现在，你可以像访问普通目录一样访问里面的文件，但所有文件都是只读的：

在你完成访问后，记得卸载挂载点：

sudo umount /mnt/etc

#在其他系统上访问

如上所述，你可以使用 7-Zip 等第三方工具在 Windows 上访问 Squashfs 文件。他可能并没有被加入默认文件关联中，所以你需要手动打开 7-Zip，然后通过它的界面打开 Squashfs 文件进行浏览和提取。在此不再赘述。

#如何解决 VPS.Town A3 VDS 上 PVE 8/9 虚拟机无法正常开机的问题

#1.问题描述

正常配置好虚拟机，开机在控制台界面上看到如下报错，无法进入登陆界面。

如果CPU是host模拟模式，关闭KVM硬件虚拟化开机，控制台提示报错：kvm: CPU model 'host' requires KVM or HVF

将CPU类型改为KVM64模式并不关闭选项内的KVM硬件虚拟化，还是有如下报错。

#2.第一种解决办法

将cpu的虚拟化类型改为KVM64并关闭虚拟机选项内的KVM硬件虚拟化

服务器正常开机

#3.第二种解决办法

将CPU模拟调整为EPYC-Milan-v2，为什么调整为这个？

是因为A3 VDS服务器的CPU是EPYC 7c13,代号： "Milan" （米兰），EPYC 7003 系列处理器。EPYC-Milan这个模拟模式比较老，EPYC-Milan-v2比较新的 Milan 微码更新，更完善的漏洞修复。

修改为EPYC-Milan-v2，如果不关闭虚拟机选项内的KVM硬件虚拟化，将会有如下报错，所以需要关闭KVM硬件虚拟化。

#4.【彩蛋】怎么让PVE虚拟出来的虚拟机更流畅（仅可用于VPS.TOWN A3虚拟化出的虚拟机）

# 以下三种任选
# 第一种：使用CPU x86_64虚拟化
cpu: x86-64-v4,flags=+virt-ssbd;+amd-ssbd;+aes
args: -cpu kvm64,accel=kvm,kvm=on,vmware-cpuid-freq=on,,+invtsc,+aes,+svm

# 第二种:使用CPU代号的虚拟化（优先推荐）
cpu: EPYC-Milan-v2,flags=+virt-ssbd;+amd-ssbd;+aes
args:  -cpu EPYC-Milan-v2,kvm=on,vmware-cpuid-freq=on,,+invtsc,+aes,+svm

# 第三种:使用CPU host方式进行虚拟化
cpu: host,flags=+virt-ssbd;+amd-ssbd;+aes
args:  -cpu max,kvm=on,vmware-cpuid-freq=on,+invtsc,+aes,+svm

操作步骤

# SSH 连接宿主机
ssh root@xx.xxx.xx.xx

# 切换到虚拟机配置文件目录下
cd /etc/pve/qemu-server

# 编辑虚拟机配置文件(这里以虚拟机ID为100的虚拟机配置文件作演示)
vi 100.conf

回到PVE网页端查看虚拟机启动完毕

#在 VPS.Town 的 Debian 12 上安装 PVE（Proxmox VE）教程

#前言

Proxmox VE（简称 PVE）是一款基于 Debian 的开源虚拟化平台，支持 KVM（完整虚拟化）和 LXC（容器化），并带有友好的 Web 管理界面。把一台 Debian 12 主机转成 PVE 节点的典型做法是：添加 Proxmox 的软件源、安装 PVE 软件包与专用内核、移除冲突的内核并重启。下面按步骤展开，逐条解释每一步的目的与常见问题。

#环境与准备（建议先读）

• 推荐环境：VPS.Town A3 系列（示例），但方法对其他云厂商的 Debian 12 通常也适用。
• 最低要求（建议更高）：1 核 CPU / 2GB RAM / 可用 IPv4 地址 / SSD 系统盘。
• 强烈建议：在开始前做好重要数据备份。

#why pve

1. pve 作为虚拟化平台

🖥️ pve 支持KVM 虚拟机和LXC 容器，可以同时跑完整系统和轻量应用环境。

2. Web 管理界面

🌐 pve 自带超好用的网页管理面板，可一键创建、监控和管理 VM 和容器。

3. 开源 & 免费

🆓 pve 基础功能完全开源免费，用起来放心。

#前置准备

#使用 dd 脚本对系统进行 dd，使用默认系统会导致安装 pve 后出现网卡丢失机子失联的情况，注意 dd 系统会导致数据丢失，请提前备份数据。

wget --no-check-certificate -qO InstallNET.sh 'https://raw.githubusercontent.com/leitbogioro/Tools/master/Linux_reinstall/InstallNET.sh' && chmod a+x InstallNET.sh

bash InstallNET.sh -debian 12 -port 22 -pwd yourspassword #请将yourspassword改为你自己的root密码

#1.修改 vps 主机名

• PVE 对主机名和主机名解析比较敏感，建议设置一个短且固定的主机名（如 pve01）。

sudo hostnamectl set-hostname pve01

#2.将主机名写入 host

• PVE 在启动和一些管理功能中，会检查主机名对应的 IP。如果主机名只解析为回环地址（127.0.0.1），会导致服务间通信或面板登录出现问题。

• 因此把主机名和真实 IP 映射写进 /etc/hosts 能保证本机解析正确。

echo "154.19.1.0 pve01" | sudo tee -a /etc/hosts
#其中154.19.1.0改为你自己vps的ip，注意不能是127.0.0.1

#3.检测主机名解析生效

• 如果返回 127.0.0.1 或 127.0.1.1，说明解析没有正确设置，需要检查 /etc/hosts。

hostname --ip-address

返回结果

注意该结果不能为回环 ip 127.0.0.1

#4.添加 pve 仓库以及密钥并更新软件包

# 添加 pve 仓库（针对 bookworm / Debian 12）
echo "deb [arch=amd64] http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-install-repo.list

# 下载并安装 Proxmox 的 GPG 公钥
wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg

# 更新并升级当前包
apt update && apt full-upgrade -y

#5.安装 pve 内核并重启

• Proxmox 使用定制的内核（包含 KVM、ZFS、网络相关的补丁与模块），安装 proxmox-default-kernel 会将系统引导到适配 PVE 的内核上。

apt install proxmox-default-kernel -y

systemctl reboot

#6.安装 pve 软件包

apt install proxmox-ve postfix open-iscsi chrony -y

• 安装过程中系统可能提示设置 postfix，默认选择 Internet Site 并填写主机名通常是可行的（按 Tab 选择 OK 并回车）。

#7.移除原本的 debian 内核

• 为了避免 pve 升级时旧内核与 Proxmox 内核冲突或引导时选择错误内核，建议移除原生 Debian 内核包。

apt remove linux-image-amd64 'linux-image-6.1*' -y

#8.最后再升级并检查 grub2 并重启一次

• update-grub 会重新生成 GRUB 引导配置，确保默认引导项为 Proxmox 内核。

update-grub && reboot

#9.然后就可以进入后台了

• 登录凭据：

用户名：root

密码：你在系统中设置的 root 密码

默认使用 HTTPS（端口 8006），浏览器可能提示自签名证书警告，可先接受例外进入界面。

https://your-ip:8006

#在 Debian 12 上安装并使用 RSStT

更关心您阅读体验的 Telegram RSS 机器人

RSS-to-Telegram-Bot (RSStT) 是一个功能强大的 Telegram 机器人，可以将 RSS 源的更新推送到 Telegram。使用 Docker Compose 是官方最推荐的部署方式，它极大地简化了安装、配置和更新过程，将应用程序及其依赖项打包在隔离的容器中运行，非常适合新手和追求便捷管理的用户。本教程将指导您如何在 Debian 12 服务器上一步步完成 Docker Compose 部署。

#1. 准备工作

与任何安装方式一样，我们首先需要获取一些必要的凭证信息。如果您已在其他教程中获取过，可以跳过此步。

#1.1 获取 Telegram Bot Token

1. 打开 Telegram，搜索并与 @BotFather 开始对话。
2. 发送 /newbot 命令，按提示设置 Bot 的名字 (Name) 和用户名 (Username, 必须以 bot 结尾)。
3. 创建成功后，复制 BotFather 发送的 HTTP API Token。妥善保管。
4. （重要） 接着，向 BotFather 发送 /setinline 命令，选择你刚创建的 Bot，然后随意回复一条消息（如：输入命令...）以启用内联模式。

然后与您的机器人对话，并发送/start命令。

#1.2 获取你的 Telegram User ID

1. 打开 Telegram，搜索并与 @userinfobot 开始对话。
2. 发送 /start 或任何消息。
3. 复制它回复的纯数字 User ID。

#1.3 获取 Telegraph API Token(s)

1. 访问 Telegraph API 创建页面（此链接会在生成的文章页脚留下 RSStT 的项目标识）。

   自定义无标识链接： https://api.telegra.ph/createAccount?short_name=YourName

2. 复制页面结果中 access_token 的值。
3. （重要） 刷新页面以获取新的、不同的 access_token。重复此操作，至少获取 5 个 Token。

#2. 服务器环境准备：安装 Docker 和 Docker Compose

Docker Compose 需要 Docker Engine 运行环境。我们将安装最新的 Docker 版本。

#2.1 更新系统软件包

首先，确保系统是最新的。

sudo apt update && sudo apt upgrade -y

#2.2 安装 Docker

1. 卸载旧版本 (如果存在):

   sudo apt remove docker docker-engine docker.io containerd runc -y

2. 安装必要的依赖包:

   sudo apt install -y ca-certificates curl gnupg lsb-release

3. 使用一键脚本

   curl -fsSL https://get.docker.com | bash

#3. 使用 Docker Compose 安装 RSStT

现在 Docker 环境准备就绪，我们可以开始部署 RSStT 了。

#3.1 创建工作目录并下载配置文件

# 创建一个专门的目录存放 RSStT 的配置和数据
mkdir ~/rsstt_docker
cd ~/rsstt_docker

# 下载官方提供的 docker-compose.yml 示例文件
wget https://raw.githubusercontent.com/Rongronggg9/RSS-to-Telegram-Bot/dev/docker-compose.yml.sample -O docker-compose.yml

#3.2 配置 docker-compose.yml 文件

docker-compose.yml 文件定义了运行 RSStT 所需的服务（即容器）及其配置。我们需要编辑它来填入之前准备好的凭证信息。

# 使用 nano 编辑器编辑文件 (也可以使用 vim 或其他编辑器)
nano docker-compose.yml

找到 services: -> rsstt: -> environment: 部分。这里定义了 RSStT 运行所需的环境变量。你需要修改以下几行：

services:
  rsstt:
    # ... (其他配置保持不变)
    environment:
      # --- Required ---
      # Telegram Bot Token (从 @BotFather 获取)
      - TOKEN=781243512:AAGSDGHSRTGHJTRDSFGDSSD # <--- 修改这里

      # Bot 管理员的 Telegram User ID (从 @userinfobot 获取)
      - MANAGER=123456789 # <--- 修改这里

      # Telegraph API Tokens (一行一个，至少一个，推荐5个)
      TELEGRAPH_TOKEN=<你的Telegraph_API_Token1>
        1599373e3dbf55515XXXXX8658d28297fa3
        f2a8f5c5db81c740bcXxxxX52287ec413
        361935c66b7XXX7ce645af19
        0702249218XXXXXc2ab7fcd981b9db820d80098c03ce6
        130f258173dXXXX10ef89adf51477535822a94fca708f578d62

      # 数据库类型 (Docker Compose 默认使用 sqlite, 数据存储在 volume 中)
      # 如果你想使用外部 PostgreSQL 数据库，需要取消注释并修改下面两行
      # - DB_TYPE=postgre
      # - DATABASE_URL=postgresql://user:password@host:port/database

      # --- Optional ---
      # Telegram API 的代理 (例如: socks5://192.168.1.100:1080, 注意这里的 IP 通常是宿主机 IP 或代理服务容器 IP)
      # - PROXY=socks5://192.168.1.100:1080
      # RSS 源的代理
      # - RSS_PROXY=http://192.168.1.100:1081

      # 启用 HTML 表格转图片 (需要容器内字体支持，官方镜像已包含)
      # - TABLE_TO_IMAGE=1

重要修改点：

• 将 <你的机器人TOKEN> 替换为你的真实 Bot Token。
• 将 <你的Telegram用户ID> 替换为你的真实 User ID。
• 将 <你的Telegraph_API_Token1> 替换为你之前生成的 Telegraph Token ，一行一个。
• 如果需要代理，请取消对应 - PROXY= 或 - RSS_PROXY= 行的注释并填入正确的代理地址。注意，如果代理在宿主机上，地址通常是宿主机的局域网 IP 或 172.17.0.1 (Docker 默认网桥 IP)，而不是 127.0.0.1。
• 默认使用 SQLite 数据库，数据会保存在 Docker Volume (rsstt-data) 中，无需额外配置。

编辑完成后，按 Ctrl + X，然后按 Y，最后按 Enter 保存并退出 nano。

#3.3 启动 RSStT 服务

现在，只需要一条命令即可启动 RSStT：

# 确保你在 ~/rsstt_docker 目录下
# 如果你没有将用户添加到 docker 组，请使用 sudo docker compose up -d
docker compose up -d

• up: 创建并启动 docker-compose.yml 文件中定义的服务。
• -d: Detached mode，表示在后台运行容器。

Docker 会自动下载 RSStT 的镜像 (如果本地没有)，然后创建并启动容器。

#3.4 检查服务状态和日志

# 查看正在运行的容器 (应该能看到名为 rsstt_docker-rsstt-1 或类似的容器)
# 如果你没有将用户添加到 docker 组，请使用 sudo docker ps
docker ps

# 查看 RSStT 容器的实时日志
# 如果你没有将用户添加到 docker 组，请使用 sudo docker compose logs -f
docker compose logs -f

如果日志滚动显示，并且没有明显的错误信息 (如 ERROR 级别的日志)，最后看到类似 INFO:telegram.ext.Application:Getting updates 的信息，说明 Bot 已经成功启动。

此时，你可以打开 Telegram，与你的 Bot 对话，发送 /start 或 /help 命令进行测试。

按 Ctrl + C 停止查看实时日志 (服务仍在后台运行)。

#4. 管理 RSStT 服务 (Docker Compose)

使用 Docker Compose 管理 RSStT 非常方便：

• 启动服务 (后台运行): docker compose up -d
• 停止并移除容器: docker compose down (数据卷 rsstt-data 默认会保留)
• 停止服务 (不移除容器): docker compose stop
• 启动已停止的服务: docker compose start
• 重启服务: docker compose restart
• 查看所有服务日志: docker compose logs
• 查看实时日志: docker compose logs -f
• 拉取最新镜像 (用于更新): docker compose pull

#5. 更新 RSStT

更新 RSStT 非常简单：

1. 进入工作目录:

   cd ~/rsstt_docker
2. 拉取最新的 Docker 镜像:

   # 如果你没有将用户添加到 docker 组，请使用 sudo docker compose pull
   docker compose pull
3. 停止当前容器并使用新镜像重新创建启动:

   # 如果你没有将用户添加到 docker 组，请使用 sudo docker compose up -d
   docker compose up -d --remove-orphans
   --remove-orphans 会移除旧版本可能遗留的不再需要的容器。

更新完成！数据因为存储在 Docker Volume 中，所以会保留下来。

#6. 常见问题与注意事项 (Docker)

• Bot 没有响应?
  • 检查容器是否在运行: docker ps (或 sudo docker ps)。
  • 查看容器日志: docker compose logs -f (或 sudo docker compose logs -f)。
  • 确认 docker-compose.yml 文件中的 TOKEN, MANAGER, TELEGRAPH_TOKEN 是否正确填写且没有多余空格。
  • 确认服务器网络是否正常，Docker 容器的网络是否能访问 Telegram API (检查代理设置 PROXY 是否正确)。
  • 确认是否启用了 inline 模式 (/setinline @BotFather)。
• RSS 抓取失败?
  • 检查 RSS 源地址是否有效。
  • 确认 Docker 容器的网络是否能访问该 RSS 源 (检查代理设置 RSS_PROXY 是否正确)。
  • 查看容器日志获取详细错误信息。
• 消息过长被截断?
  • 确认 docker-compose.yml 文件中的 TELEGRAPH_TOKEN 是否配置正确且有效 (确保有多个，用逗号分隔)。
  • 检查容器日志看是否有 Telegraph 相关的错误。
• 数据持久化: docker-compose.yml 文件中定义了名为 rsstt-data 的 Docker Volume。只要你不手动删除这个 Volume (docker volume rm rsstt_docker_rsstt-data)，你的订阅和配置信息就会在容器停止、重启或更新后保留下来。
• 资源占用: 可以使用 docker stats (或 sudo docker stats) 命令查看 RSStT 容器的实时资源使用情况 (CPU, 内存等)。

#7.使用

现在您的 RSStT 机器人已经在 Docker 中成功运行，是时候开始使用它来订阅和管理 RSS 源了。以下是一些基本的操作指令：

#7.1 添加订阅

这是核心功能，用于添加新的 RSS 源。

• 为自己订阅 (Bot 向私聊发送信息):

  • 订阅单个源: /sub <RSS 订阅 URL> 将<RSS 订阅 URL>替换为你想要订阅的 url，例如/sub https://rss.nodeseek.com/

  • 批量订阅: /sub <URL1> <URL2> ... (url之间用空格分隔) 例如：/sub https://rss.nodeseek.com/ https://docs.vps.town/rss/event.xml

• 为群组/频道订阅:

  • 首先，将机器人添加为群组成员或频道管理员(需发布消息权限)。

  • 将机器人加入至群组的步骤：

  • 将机器人加入至频道的步骤：

  • 方法一 (直接在群组/频道内):

    • 在群组或频道内直接发送 /sub <RSS 订阅 URL>。

  • 方法二 (在与 Bot 的私聊中指定目标):

    • 使用用户名: /sub @频道或群组用户名 <RSS 订阅 URL> 例如：/sub @MyChannelName https://example.com/feed.xml (注意：@ 符号必不可少)
      

    • 使用 Chat ID: /sub <频道或群组ID> <RSS 订阅 URL> 例如：/sub -1001234567890 https://example.com/feed.xml

      (注意：频道/群组 ID 通常以 -100 开头。您可以通过转发频道/群组消息给 @userinfobot 等方式获取 ID)

#7.2 管理订阅

对于在群组或频道中的管理可以参见 7.1：在群组或频道内直接发送命令或在与 Bot 的私聊中指定目标

• 列出订阅: 发送 /list 查看您（或当前群组/频道）的所有订阅。
• 取消订阅:
  • 发送 /unsub，机器人会列出订阅并提供按钮供您选择取消。
  • 或发送 /unsub <RSS 订阅 URL> 直接指定取消。
• 全部取消订阅: 发送 /unsub_all 将一次性取消当前聊天（私聊、群组或频道）中的所有 RSS 订阅。请谨慎使用！
• 停用订阅: 发送 /deactivate_subs，可以选择暂时停止接收某些源的更新，但保留订阅关系。
• 启用订阅: 发送 /activate_subs，可以选择重新启用之前被停用的订阅源。

#7.3 导入与导出

方便地迁移和备份您的订阅列表。

• 导入订阅: 发送 /import 命令，然后按提示上传一个 OPML 文件 (一种常见的 RSS 订阅列表格式)。机器人会将文件中的订阅源添加到当前聊天。
• 导出订阅: 发送 /export，机器人会将当前聊天的所有订阅打包成一个 OPML 文件发送给您，方便备份或迁移到其他阅读器。

#7.4 自定义设置

调整订阅和机器人的行为。

• 单个订阅设置: 发送 /set，可以选择一个已订阅的源，并对其进行详细设置（如：通知格式、过滤规则、Webpage Preview 等）。这是进行精细化管理的入口。
• 默认设置: 发送 /set_default，可以为之后新添加的订阅设置默认的行为（类似 /set 中的选项，但作为默认值）。
• 选择语言: 发送 /lang，可以更改机器人界面的显示语言。

#7.5 Bot 管理员命令 (仅限 MANAGER 用户 ID)

这些命令仅限在 docker-compose.yml 中配置为 MANAGER 的用户 ID 在与机器人私聊时使用。

• 测试订阅源: 发送 /test <RSS 订阅 URL> 来检查机器人是否能成功抓取和解析该源。这对于诊断问题非常有用。
• 更改 Bot 配置: 允许 Bot 管理员修改一些全局性的机器人配置参数。
• 用户信息: 查看或修改与特定用户相关的信息（通常用于管理）。

#7.6 其他命令

• 查看版本: 发送 /version 查看当前运行的 RSStT 机器人版本。

#7.7 获取帮助 (/help):

发送 /help 显示所有可用命令及其简要说明，您可以自行探索该机器人的更多用法。

#8. 结语

恭喜！您已经通过 Docker Compose 在 Debian 12 服务器上成功部署并运行了 RSS-to-Telegram-Bot。这种方式不仅安装过程简洁，后续的维护和更新也十分方便。

现在，您可以开始在 Telegram 上与您的 Bot 互动，添加您想要关注的 RSS 源了。

如果遇到任何问题或想了解更多高级功能，请查阅官方文档：

• 项目仓库: https://github.com/Rongronggg9/RSS-to-Telegram-Bot
• 文档导航: docs
• FAQ: docs/FAQ.zh.md

#vps.town 磁盘扩容新手指南

#1. 准备工作

# 查看系统中是否安装了 LVM 管理工具
apt list --installed | grep lvm2
# 如提示未安装，执行下面命令安装
apt install lvm2
# 检查系统磁盘情况
fdisk -l | grep /dev/vd | grep -v vda

一般默认除系统盘后，系统第一个磁盘是/dev/vdb、第二个是/dev/vdc

#查看当前磁盘情况

使用命令 fdisk -l 或者 lsblk 找到新增的未分区的磁盘。

for file in `ls /sys/class/scsi_host`; \
do echo '- - -' > /sys/class/scsi_host/$file/scan ; \
done

#2. 原磁盘本身扩容

适用情况:原磁盘已有分区，但申请了新增了磁盘空间 类似于下图：本身 vdb1 只有 500GB，但对 vdb 磁盘新增了 500G，本次需要对 vdb1 扩容至 1000G

#2.1 取消原磁盘挂载

vim /etc/fstab
注释以下行`# /dev/vdb1 /home ext4 defaults 0 0`并`ESC`和`:wq`保存退出

mount -a
umount /home  ## 取消/home挂载

#2.2 转为 GPT 格式

gdisk /dev/vdb  # 选择磁盘
w               # 写入，是否转为GPT格式
Y               # 确定转格式
# 等待执行完成

#2.3 调整分区大小

# 检查文件系统
e2fsck -f /dev/vdb1

# 使用 parted 调整分区
parted /dev/vdb                      # 操作磁盘
               print                 # 打印信息
(parted)       resizepart 1          # 选择分区
End? [500GB]?  100%                  # 扩展到全部空间
(parted)       quit                  # 退出

# 扩展文件系统
resize2fs /dev/vdb1

#2.4 重新挂载

mount /dev/vdb1 /home
vim /etc/fstab
# 注释以下行`/dev/vdb1 /home ext4 defaults 0 0`并`ESC`和`:wq`保存退出

#2.5 检查磁盘挂载情况

mount -a
lsblk
df -hT

#3. 新增磁盘扩容，与原有磁盘合并

适用情况:已有磁盘/dev/vdb，需要将新磁盘/dev/vdc 合并，即把/dev/vdc 空间和/dev/vdb 合并使用

#3.1. 备份原本磁盘数据（/dev/vdb->/dev/vdc）

#3.1.1 在新硬盘上创建新分区并格式化

# 查看新硬盘信息
fdisk -l /dev/vdc

# 创建新分区
fdisk /dev/vdc
g    # 新建一份 GPT 分区表
n    # 添加新分区
     # 默认回车 分区号
     # 默认回车 第一个扇区
     # 默认回车 大小
w    # 将分区表写入磁盘并退出

# 格式化分区
mkfs.ext4 /dev/vdc1

# 验证分区创建
fdisk -l /dev/vdc1

#3.1.2 将旧硬盘内容传输至新硬盘

# 建议先验证源分区和目标分区的大小，需求 vdc 区大于或等于 vdb 区
fdisk -l /dev/vdb1 /dev/vdc1

# 开始数据迁移
dd if=/dev/vdb1 of=/dev/vdc1 bs=512M
# 可以再开一个终端执行此命令查看进度
watch -n 10 kill -USR1 $(ps aux | grep "dd if=/dev/vdb1"|grep -v grep|awk '{print $2}')

#3.2 修改原磁盘为 LVM 卷组（如 /dev/vdb）

#3.2.1 删除 /dev/vdb 当前分区

# 卸载正在使用的硬盘
umount /dev/vdb1
# 如果提示设备正忙，可以使用 fuser 命令查看正在操作硬盘的进程，并合理关闭它们
fuser -cu /dev/vdb1 # 找到进程号
ps -ef|grep 进程号  # 找到对应进程
kill -9 进程号      # 杀死进程
# 如当前终端处于 /home 路径，切换到其他路径，如 `cd /`，避免占用

# 删除磁盘分区
fdisk /dev/vdb
d    # 删除分区
w    # 将分区表写入磁盘并退出

#3.2.2 将 /dev/vdb 转换为 LVM 卷组

# 检查当前磁盘状态
lsblk
fdisk -l /dev/vdb
# 清除磁盘签名，会删除 /dev/vdb 数据
wipefs -a /dev/vdb

# 创建物理卷 (PV)
pvcreate /dev/vdb
# 创建卷组 (VG)
vgcreate vg_data /dev/vdb
# 创建逻辑卷 (LV)
lvcreate -n lv_data -l 100%FREE vg_data
# 格式化逻辑卷 (LV)，**需要等一会儿执行完成**
mkfs.ext4 /dev/mapper/vg_data-lv_data
# 挂载逻辑卷 /home
mount /dev/mapper/vg_data-lv_data /home

# 设置自动挂载
vim /etc/fstab
# 按a进入编辑模式，添加下面一行
/dev/mapper/vg_data-lv_data /home ext4 defaults 0 0
# esc 后再 :wq 保存

# 手动挂载
mount -a
# 检查挂载情况
df -h

重启机器后，检查挂载情况

#3.3 将新硬盘上的数据传至 LVM 卷组

# 开始数据迁移，**等待执行完成**
dd if=/dev/vdc1 of=/dev/mapper/vg_data-lv_data bs=512M
# 可以再开一个终端执行此命令查看进度
watch -n 10 kill -USR1 $(ps aux | grep "dd if=/dev/vdc1"|grep -v grep|awk '{print $2}')

#3.4 将新硬盘加入 LVM 卷组

# 删除原有分区
fdisk /dev/vdc
d    # 删除分区
n    # 添加新分区
     # 默认回车 分区号
     # 默认回车 第一个扇区
     # 默认回车 大小
w    # 将分区表写入磁盘并退出

# 通知操作系统分区表更新
partprobe /dev/vdc

# 查看 pv 信息
pvs
# 创建 pv
pvcreate /dev/vdc

# 扩展卷组(VG)空间
vgextend vg_data /dev/vdc # 往 vg_data 添加
lvextend -l +100%FREE /dev/mapper/vg_data-lv_data # 100%空间分配

#3.5 扩容 LVM 卷组的文件系统

# 检查当前文件系统类型
df -hT
# 根据文件系统类型选择扩容命令
# 如果是 ext4 文件系统
resize2fs -p /dev/mapper/vg_data-lv_data
# 如果是 xfs 文件系统
# xfs_growfs /dev/mapper/vg_data-lv_data

# 检查挂载信息
df -hT

#4. 注意事项

#在 VPS.Town 上部署 Vaultwarden 密码管理器完全指南

#前言

在当今数字化时代，我们每天都需要使用大量的账号和密码。使用简单或重复的密码会带来严重的安全风险，而记住众多复杂密码又几乎不可能。这就是为什么我们需要一个可靠的密码管理工具。

Vaultwarden 是 Bitwarden 的一个非官方实现，它是一个开源的密码管理解决方案，允许您安全地存储和管理您的密码、信用卡信息、身份信息和其他敏感数据。与商业密码管理器不同，Vaultwarden 可以自托管，这意味着您的数据完全由您自己控制，不依赖于第三方服务。

#Vaultwarden 的主要特点：

• 开源且免费：完全开源，无需支付订阅费用
• 自托管：您的数据存储在您自己的服务器上，提高隐私保护
• 跨平台支持：提供 Windows、macOS、Linux、iOS 和 Android 客户端
• 浏览器扩展：支持 Chrome、Firefox、Safari 等主流浏览器
• 强大的加密：使用 AES-256 加密、PBKDF2 和 SHA-256 哈希算法
• 资源占用低：相比官方 Bitwarden 服务器，Vaultwarden 对系统资源要求更低
• 功能丰富：支持密码生成、安全笔记、身份信息管理、文件附件等

本教程将指导您如何使用 Docker 在自己的服务器上部署 Vaultwarden，并进行基本配置和使用。

#1. 安装 Docker 和 Docker Compose

# 更新软件包索引，下载 Docker 官方 GPG 密钥，并允许所有人读取
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/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# 将 Docker 仓库添加到 Apt 源列表
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

# 安装 docker 软件包
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

# 启动 docker 服务和开机自启
systemctl enable docker
systemctl restart docker

# 验证安装
systemctl status docker
docker compose version

● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since ...

#2. 安装 vaultwarden

# 创建数据目录
mkdir -p /opt/vaultwarden
cd /opt/vaultwarden

# 创建 docker-compose.yml 文件
sudo cat > /opt/vaultwarden/docker-compose.yml <<EOF
services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: unless-stopped
    environment:
      DOMAIN: "https://vw.domain.tld/vault"  ## 修改为您自己的域名
    volumes:
      - ./vw-data/:/data/
    ports:
      - 10080:80  ## （可选）修改前面的映射端口
EOF

# 启动服务
docker compose up -d

执行docker ps查看程序启动状态

#3. 配置反向代理

以 nginx 为例，修改 nginx.conf，添加类似于如下配置：

location /vault/ { # 注意这个路径和上面 docker 配置的域名路径名一致
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_pass http://127.0.0.1:10080;
}

重启 nginx：service nginx restart

使用浏览器访问 https://vw.domain.tld/vault

#4. 账户设置和浏览器插件使用

#4.1 创建账户

1. 点击"创建账户"

2. 填写您的账户信息

3. 创建完成后，登录您的账户

#4.2 安装浏览器扩展

1. 安装扩展

2. 配置扩展信息，固定到标签栏

3. 选择自托管，输入您的域名（如 https://vw.domain.tld/vault），再输入您注册的账户和密码

4. 之后登录或注册网站时，会提示您是否要保存密码

#5. 安全建议

#6. 故障排除

#6.1 常见问题

1. 无法访问 Web 界面

   • 检查 Docker 容器是否正常运行：docker ps
   • 检查端口是否正确映射：netstat -tulpn | grep 10080
   • 检查 Nginx 配置是否正确

2. 无法保存密码

   • 检查浏览器扩展是否正确配置
   • 确认服务器地址是否正确
   • 检查网络连接是否正常

3. 数据同步问题

   • 检查服务器状态
   • 尝试重新登录账户
   • 检查网络连接

#6.2 日志查看

# 查看容器日志
docker logs vaultwarden

# 实时查看日志
docker logs -f vaultwarden

#7. 备份与恢复

#7.1 备份数据

# 创建备份目录
mkdir -p /backup/vaultwarden

# 备份数据
tar -czf /backup/vaultwarden/backup-$(date +%Y%m%d).tar.gz /opt/vaultwarden/vw-data/

#7.2 恢复数据

# 停止服务
cd /opt/vaultwarden
docker compose down

# 恢复数据
tar -xzf /backup/vaultwarden/backup-YYYYMMDD.tar.gz -C /

# 重启服务
docker compose up -d

#8. 更新 Vaultwarden

# 进入项目目录
cd /opt/vaultwarden

# 拉取最新镜像
docker compose pull

# 重启服务
docker compose up -d

#如何使用 Acme.sh 自动更新 Nginx 网站证书

#1. acme.sh 安装

# 将 my@example.com 换成您自己的邮箱地址
curl https://get.acme.sh | sh -s email=my@example.com

#2. 使用 CloudFlare DNS api 验证

#2.1. 添加您的域名到 CloudFlare

• 账户主页-添加域：按照页面指示添加您的个人域名

• 选择计划：选择下方的free计划，点击继续

• dns记录：会自动导入已有的 dns 记录，检查没什么问题，点击继续

• 更新名称服务器：根据指引，在您域名之前网站，修改 ns 记录。主要删除原来的 dns 锁定和删除并添加新的 ns 记录

• 验证：修改完成后，检查添加状态是否正常，如不正常，可手动最下方立即检查或手动检查添加过程是否正确

#2.2. 创建 API 令牌

• 点击创建令牌
• 选择使用模版 编辑区域dns
• 权限配置
• 确定创建令牌
• 复制生成的 token 值

#2.3. 区域 ID 和账户 ID

#2.4. 申请 SSL 域名证书

# API令牌：上述步骤获取的令牌token值
export CF_Token="Y_jpG9AnfQmuX5Ss9M_qaNab6SQwme3HWXNDzRWs"

# 以下二选一
# 单个域名：上述区域ID值
export CF_Zone_ID="763eac4f1bcebd8b5c95e9fc50d010b4"
# 多个域名：上述账户ID值
# export CF_Account_ID="763eac4f1bcebd8b5c95e9fc50d010b4"

• 配置以上环境变量后，手动执行申请

# 以下申请ssl通配证书，根据提示操作
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com'

检查脚本执行日志，是否获取证书正常，提示证书文件保存在何地

• 后续定期更新，是由计划任务 cron 里的定期检查和自动更新

#3. nginx 等程序配置 ssl

在nginx.conf配置文件，添加 ssl 相关配置并重启服务，浏览器检查 https 访问是否正常。以下供参考：

        ssl_certificate      /opt/ssl_cert.pem;
        ssl_certificate_key /opt/ssl_key.pem;

        ssl_protocols             TLSv1.2 TLSv1.3;
        ssl_prefer_server_ciphers on;
        ssl_ciphers               ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305;
        ssl_ecdh_curve            secp521r1:secp384r1:secp256r1:x25519;

#如何在 VPS.Town 服务器上安装并配置青龙面板

#1. 安装 Docker 和 Docker Compose

#1.1 更新软件包索引

# 更新软件包索引，下载 Docker 官方 GPG 密钥，并允许所有人读取
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/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

#1.2 添加 Docker 仓库

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

#1.3 安装 Docker 和 Docker Compose

# 更新软件包索引
sudo apt-get update

# 安装docker软件包
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

# 启动docker服务和开机自启
systemctl enable docker
systemctl restart docker

# 验证安装
systemctl status docker
docker compose version

验证显示 docker 启动正常，docker compose 版本号显示正常即可，如下图：

#2. 安装青龙面板

#2.1 创建路径

# 创建路径
mkdir -p /opt/qinglong
cd /opt/qinglong

#2.2 创建 docker compose 文件

创建 docker compose 文件，可修改映射目录./data、映射端口 5700

sudo cat > /opt/qinglong/docker-compose.yml <<EOF
services:
  web:
    image: whyour/qinglong:latest
    volumes:
      - ./data:/ql/data
    ports:
      - "5700:5700"
    environment:
      QlBaseUrl: '/'
    restart: unless-stopped
EOF

#2.3 启动青龙面板

# 启动青龙面板
docker compose up -d

#2.4 安装完成

如下图状态，即启动正常

#3、青龙面板配置

• 打开浏览器访问: http://ip 地址:5700
• 首次访问需要设置管理员账号和密码

#3.1 通知配置

以配置 telegram 机器人为例

• 先申请个人机器人 与 @BotFather 对话，创建机器人
• 输入机器人名称，名称需要以 bot 结尾，然后拿到token
• 创建机器人成功后，需要主动对话一次才可使机器人实际生效
• 获取个人 userid 与 @userinfobot 对话，随便输入，拿到个人userid

把上方获取到的机器人 token 和个人 userid 填入上方的通知配置中

#3.2 用户名、密码设置

保存后，输入用户名和密码后登陆后台

#3.3 青龙后台

#如何使用青龙面板定时运行 Bilibili 日常签到脚本

#1. 登录青龙面板并修改配置文件

青龙面板，配置文件页。

• 修改RepoFileExtensions="js mjs py pyc" 为 RepoFileExtensions="js mjs py pyc sh"
• 新增export BILI_MODE="bilitool" # bili运行模式，dotnet或bilitool

#2、拉取库文件

青龙面板，订阅管理页，点击右上角创建订阅

名称: Bilibili
类型: 公开仓库
链接: https://github.com/RayWangQvQ/BiliBiliToolPro.git
定时类型: crontab
定时规则: 1 0 * * *
白名单: bili_task_.+\.sh
文件后缀: sh

点击确定后，点击运行拉取库文件 可点击日志，检查拉取过程是否正常

#3. 检查定时任务

如果正常，拉库成功后，会自动添加 bilibili 相关的 task 任务。

#4. 登录获取 cookie

首次运行会自动安装环境，时间可能长一点，之后就不需要重复安装了。

在青龙定时任务中，点击运行 bili扫码登录 任务，查看运行日志，扫描日志中的二维码进行登录。

登录成功后，会提示手动保存 cookie：

手工设置 cookie

#5. 手动执行bili每日任务任务

#VPS.Town 服务器新手入门保姆级教程

#1. 网站管理界面

#1.1 已开通产品列表

购买产品之后，可在个人中心-已开通产品内看到购买的服务器。如下图：

在已开通产品列表中，您可以：

• 查看所有已购买的服务器
• 查看每个服务器的基本信息（如服务器名称、状态等）
• 通过操作按钮进入具体服务器的管理界面

#1.2 服务器列表界面

点击进入管理界面，其中有 IP 信息、管理，如下图：

在服务器列表界面中，您可以：

• 查看服务器的 IP 地址信息（点击后可看到具体的 IPv6 地址）
• 查看服务器的运行状态
• 进行服务器的基本操作（如重启、关机等）
• 查看服务器的配置信息

#1.3 服务器详情界面

点击操作按钮，进入具体服务器管理页面，如下图，主要有以下关键信息：

在服务器详情界面中，您可以：

• 查看服务器的详细配置信息
• 进行服务器的各项管理操作
• 查看服务器的使用统计信息
• 管理服务器的安全组设置
• 查看服务器的监控信息

#2. 远程连接服务器

初始安装时，默认是支持使用用户名、密码的 SSH 连接，以下以 Putty 工具为例：

#2.1 下载 Putty

您可以在 官方网站 下载 Putty 的客户端。点此直接下载 Windows 64 位版

#2.2 添加新主机并配置信息

#2.2.1 配置地址和端口

在 session 页填写服务器IP 地址、端口

#2.2.2 连接实例

点击 Open 按钮连接到实例。如果是第一次连接到实例，可能会看到对于密钥的验证信息。点击 Accept 按钮确认连接即可。连接成功后，会提示你输入用户名、密码，校验成功后进入控制台。即可开始 linux 管理。

#3.（可选项）是否网络重装操作系统

使用 dd 脚本 重装操作系统。

#下载 dd 脚本到本地

# 使用 curl 或 wget 下载 reinstall.sh 脚本
# -O: 将下载的文件保存为指定名称
curl -O https://raw.githubusercontent.com/bin456789/reinstall/main/reinstall.sh || wget -O reinstall.sh $_

#选择要重装的操作系统

以下示例为重装为 Ubuntu 22.04 最小化版本：

# 执行重装脚本
# ubuntu: 目标操作系统
# 22.04: 版本号
# --minimal: 最小化安装，只安装基本系统
bash reinstall.sh ubuntu 22.04 --minimal

执行后，会提示输入重装后的密码，命令执行完成后，输入 reboot 重启操作系统，等待约 5-10 分钟后，使用 SSH 工具重新连接服务器。

bash reinstall.sh anolis      7|8|23
                  opencloudos 8|9|23
                  rocky       8|9
                  redhat      8|9   --img="http://xxx.com/xxx.qcow2"
                  oracle      8|9
                  almalinux   8|9
                  centos      9|10
                  fedora      40|41
                  nixos       24.11
                  debian      9|10|11|12
                  opensuse    15.6|tumbleweed
                  alpine      3.18|3.19|3.20|3.21
                  openeuler   20.03|22.03|24.03|25.03
                  ubuntu      16.04|18.04|20.04|22.04|24.04|24.10 [--minimal]
                  kali
                  arch
                  gentoo
                  aosc
                  fnos

#4. 修改密码

# 切换到 root 用户
sudo -i

# 修改 root 用户密码
# root:<password>: 设置 root 用户的密码
# chpasswd: 批量修改用户密码的命令
echo root:<password> |sudo chpasswd root

#5. 优化 SSH 配置

# 配置系统更新后自动重启
sudo sed -i "s/^#\?\$nrconf{restart}.*/\$nrconf{restart} = \'a\';/g" /etc/needrestart/needrestart.conf;

# 删除可能冲突的 SSH 配置文件
rm -rf /etc/ssh/sshd_config.d/*.conf

# 修改 SSH 配置
sudo sed -i 's/^#\?PermitRootLogin.*/PermitRootLogin yes/g' /etc/ssh/sshd_config;  # 启用 root 登录
sudo sed -i 's/^#\?Port.*/Port 3022/g' /etc/ssh/sshd_config;                     # 修改默认端口为 3022
sudo sed -i 's/^#\?PasswordAuthentication.*/PasswordAuthentication yes/g' /etc/ssh/sshd_config;  # 启用密码认证
sudo sed -i 's/^#\?UseDNS.*/UseDNS no/g' /etc/ssh/sshd_config;                   # 禁用 DNS 反向解析
sudo sed -i 's/^#\?GSSAPIAuthentication.*/GSSAPIAuthentication no/g' /etc/ssh/sshd_config;  # 禁用 GSSAPI 认证
sudo sed -i 's/^#\?ClientAliveInterval.*/ClientAliveInterval 60/g' /etc/ssh/sshd_config;    # 设置客户端活动检测间隔
sudo sed -i 's/^#\?ClientAliveCountMax.*/ClientAliveCountMax 10/g' /etc/ssh/sshd_config;    # 设置客户端活动检测最大次数
sudo sed -i 's/^#\?X11Forwarding.*/X11Forwarding no/g' /etc/ssh/sshd_config;                # 禁用 X11 转发

# 修改 systemd socket 配置
sudo sed -i 's/^#\?ListenStream.*/ListenStream=3022/g' /usr/lib/systemd/system/ssh.socket;

# 重启 SSH 服务
service sshd restart
systemctl daemon-reload
systemctl restart ssh.socket

#6. 优化内核参数

tee -a /etc/sysctl.conf << EOF
net.core.default_qdisc=fq
net.ipv4.tcp_congestion_control=bbr
net.ipv4.tcp_available_congestion_control=cubic bbr
net.ipv4.tcp_fastopen=3
net.ipv4.tcp_keepalive_time=600
net.ipv4.tcp_keepalive_intvl=30
net.ipv4.tcp_keepalive_probes=5
net.ipv4.tcp_rmem=8192 262144 536870912
net.ipv4.tcp_wmem=4096 16384 536870912
EOF

# 应用配置
sysctl -p

#7. 安装常用软件

# 设置时区
sudo timedatectl set-timezone Asia/Shanghai

# 更新软件包列表并安装常用工具
apt update
apt install wget net-tools telnet fail2ban cron zip -y

#8. 防火墙配置

# 安装防火墙工具
sudo apt-get install iptables-persistent

# 配置防火墙持久化，防止重启后失效
sudo echo -e "# CLOUD_IMG: This file was created/modified by the Cloud Image build process\nIPTABLES_RESTORE_NOFLUSH=no\nIP6TABLES_RESTORE_NOFLUSH=no" > /etc/default/netfilter-persistent
sudo iptables-save | awk '{if($1=="COMMIT"){delete x}}$1=="-A"?!x[$0]++:1' | sudo iptables-restore
sudo netfilter-persistent save
sudo netfilter-persistent reload

# 清除现有规则
sudo iptables -P INPUT DROP
sudo iptables -P FORWARD DROP
sudo iptables -P OUTPUT ACCEPT
sudo iptables -F
sudo iptables -X
sudo iptables -Z

# 配置基本规则
sudo iptables -A INPUT -i lo -j ACCEPT
sudo iptables -A OUTPUT -o lo -j ACCEPT
sudo iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT

# 开放必要端口
sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 22 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 80 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 443 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 8001:9999 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 8001:9999 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 3022 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 3022 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 5700 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 5700 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 7000 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 7000 -j ACCEPT

# 允许 ICMP (ping)
sudo iptables -A INPUT -p icmp --icmp-type 8 -j ACCEPT
sudo iptables -A INPUT -p icmp --icmp-type 0 -j ACCEPT

# 配置端口转发
iptables -t nat -A PREROUTING -p udp --dport 8001:9999 -j REDIRECT --to-ports 443
iptables -t nat -L PREROUTING -v -n

# 保存并应用配置
sudo iptables -L -v -n
sudo netfilter-persistent save
service iptables restart

#9. 增加历史执行命令记录

sudo bash -c 'cat >> /etc/profile <<EOF
# 配置历史记录的时间格式
export HISTTIMEFORMAT="%Y-%m-%d %H:%M:%S "

# 设置保存历史记录的文件路径
HISTORY_FILE="\$HOME/command_history.log"

# 自定义命令日志函数
log_command() {
    local HISTFILE_PATH=\$HISTFILE
    local HIST_ENTRY_NUMBER=\$1
    local HIST_ENTRY="\$(history \$HIST_ENTRY_NUMBER | tail -n 1)"
    local CURRENT_USER=\$(whoami)
    local LOG_ENTRY="[USER: \$CURRENT_USER] \$HIST_ENTRY"

    echo "\$LOG_ENTRY" >> \$HISTORY_FILE
}

# 在每个命令之后，将命令追加到自定义的日志文件中，同时同步到 HISTFILE
PROMPT_COMMAND="history -a; log_command 1"
ulimit -SHn 1000000
EOF'

# 应用配置
source /etc/profile

#10. 可选配置

#10.1 禁用检测更新

sudo bash -c 'cat > /etc/apt/apt.conf.d/10periodic <<EOF
APT::Periodic::Update-Package-Lists "0";
APT::Periodic::Download-Upgradeable-Packages "0";
APT::Periodic::AutocleanInterval "0";
EOF'

sudo bash -c 'cat > /etc/apt/apt.conf.d/20auto-upgrades <<EOF
APT::Periodic::Update-Package-Lists "0";
APT::Periodic::Unattended-Upgrade "0";
EOF'

#10.2 登录提示文字优化

sudo sed -i 's/^#\?ENABLED=.*/ENABLED=0/g' /etc/default/motd-news;
touch /var/lib/ubuntu-advantage/hide-esm-in-motd
touch /var/lib/update-notifier/hide-esm-in-motd
rm -rf /var/lib/update-notifier/updates-available
chmod -x /etc/update-motd.d/90-updates-available
sudo rm /var/lib/ubuntu-release-upgrader/release-upgrade-available
sudo sed -i 's/^#\?Prompt.*/Prompt=never/g' /etc/update-manager/release-upgrades;

#10.3 安装 fail2ban，保护您的服务器

apt update
apt install wget net-tools telnet -y
apt install fail2ban -y

#配置规则

cat > /etc/fail2ban/jail.local <<EOF
# 默认规则
[DEFAULT]
# 白名单,不受规则限制，以下规则为每60秒错误2次，永久封禁，限制访问所有端口
ignoreip = 127.0.0.1/8 ::1 223.104.0.0/16
findtime = 60s
maxretry = 2
bantime = -1
action = iptables-allports

# sshd拦截规则，注意端口填写，默认为22
[sshd]
enabled  = true
port    = 22
logpath = /var/log/auth.log

EOF

#重启服务

systemctl restart fail2ban
systemctl enable fail2ban
systemctl status fail2ban

#常用命令

# 查看fail2ban状态
fail2ban-client status

# 查看sshd jail状态
fail2ban-client status sshd

# 解封IP
fail2ban-client set sshd unbanip IP地址

# 查看被封禁的IP列表
fail2ban-client banned

#配置详解

#主配置文件

Fail2Ban 的主配置文件是/etc/fail2ban/fail2ban.conf，建议创建副本/etc/fail2ban/fail2ban.local进行修改。

#封禁配置

• bantime: 封禁时间长度，单位可以是 m(分钟)、d(天)或 s(秒)
• findtime: 计算登录失败的时间窗口
• maxretry: 最大失败尝试次数
• ignoreip: 白名单 IP，多个 IP 用空格分隔
• action: 封禁时采取的动作
  • action_: 默认动作，拒绝流量
  • action_mw: 封禁并发送邮件通知
  • action_mwl: 封禁并发送邮件通知，包含相关日志
  • action_xarf: 封禁并发送 XARF 格式邮件

#注意事项

1. 如果 SSH 使用密钥登录并禁用密码登录，则不需要 Fail2Ban 保护
2. 修改配置后需要重启 fail2ban 服务才能生效
3. 建议将常用 IP 加入白名单，避免误封
4. 封禁时间设置要合理，避免影响正常用户

#常见问题

#启动服务报错，提示/var/log/auth.log 文件不存在

# 最小化系统，未启用日志服务，执行以下命令启用
sudo apt-get update
sudo apt-get install rsyslog
sudo systemctl start rsyslog
sudo systemctl enable rsyslog
sudo systemctl status rsyslog

#防火墙未启用，导致 fail2ban 未实际生效，以下启用防火墙参考

systemctl restart iptables
systemctl enable iptables
systemctl status iptables

#如何在 VPS.Town 服务器中安装 Syncthing

#什么是 Syncthing?

Syncthing 是一个开源、免费、跨平台的点对点 (P2P) 文件同步工具。与传统的云存储服务（如 Dropbox 或 Google Drive）不同，Syncthing 的数据传输是去中心化的，直接在您控制的设备之间进行，不经过任何中央服务器。这为您提供了更高的数据隐私性和控制权。

在 VPS.Town 服务器上使用 Syncthing 可以带来诸多便利：

• 服务器文件备份： 将服务器上的重要配置文件、网站数据等实时同步到您的本地电脑或其他服务器。
• 多服务器文件分发： 如果您管理多个 VPS.Town 实例，可以使用 Syncthing 轻松地将文件或更新分发到所有实例。
• 构建个人同步云： 结合 VPS.Town 服务器的稳定在线特性，您可以将其作为同步网络中的一个可靠节点。

本教程将指导您在基于 Debian 12 的 VPS.Town 服务器上安装和基本配置 Syncthing。

#为什么选择 VPS.Town?

#准备工作

在开始之前，请确保您满足以下条件：

• 至少拥有一台运行 Debian 12 的服务器实例。
• 您需要同步的另一台设备（可以是本地电脑 Windows/macOS/Linux，或另一台服务器）。
• 具备基本的 Linux 命令行操作知识。
• 拥有服务器的 root 权限或 sudo 权限。

#在 VPS.Town 服务器 (Debian 12) 上安装 Syncthing

我们将使用 Syncthing 官方推荐的 APT 仓库进行安装，以确保获取最新版本。该方法在 Debian 12 上运行良好。

1. 安装依赖 (如果需要): 确保 curl 和 gpg 已安装。通常 Debian 12 默认包含，但执行一下无妨。

   sudo apt update
   sudo apt install curl gpg -y

2. 添加 Syncthing 的 PGP 密钥：

   sudo curl -s -o /usr/share/keyrings/syncthing-archive-keyring.gpg https://syncthing.net/release-key.gpg

   这条命令会下载 Syncthing 的发布密钥并保存到指定位置，用于验证软件包的真实性。

3. 添加 Syncthing 的 APT 仓库： 推荐使用 stable (稳定版) 频道。

   echo "deb [signed-by=/usr/share/keyrings/syncthing-archive-keyring.gpg] https://apt.syncthing.net/ syncthing stable" | sudo tee /etc/apt/sources.list.d/syncthing.list

   这条命令将 Syncthing 的稳定版仓库地址写入 APT 的源列表文件中。

4. 更新软件包列表并安装 Syncthing：

   sudo apt update
   sudo apt install syncthing -y

   首先更新本地的软件包索引，然后执行安装命令。

5. 验证安装：

   syncthing --version

   如果看到 Syncthing 的版本号输出，则表示安装成功，输出应该类似于这样：

   syncthing v1.29.5 "Gold Grasshopper" (go1.24.2 linux-amd64) debian@github.syncthing.net 2025-04-12 12:55:24 UTC [noupgrade]

#首次配置与访问 Web UI

Syncthing 提供了一个基于 Web 的图形用户界面 (GUI) 来进行管理。默认情况下，它只监听本地回环地址 (127.0.0.1) 的 8384 端口，需要修改配置才能从外部访问。

1. 首次运行 Syncthing (生成配置)： 在服务器上执行一次 syncthing 命令(最好是非 root 的普通用户)，它会生成默认的配置文件，然后按 Ctrl+C 停止它。

   syncthing
   
   #下面是我执行以后输出的最后几行
   # [35WMX] 2025/04/13 21:15:25 INFO: Creating new HTTPS certificate
   #[35WMX] 2025/04/13 21:15:25 INFO: Ready to synchronize "Default Folder" (default) (sendreceive)
   #[35WMX] 2025/04/13 21:15:25 INFO: Completed initial scan of sendreceive folder "Default Folder" (default)
   #[35WMX] 2025/04/13 21:15:25 INFO: GUI and API listening on 127.0.0.1:8384
   #[35WMX] 2025/04/13 21:15:25 INFO: Access the GUI via the following URL: http://127.0.0.1:8384/
   #[35WMX] 2025/04/13 21:15:25 INFO: My name is "HKG-A2-AF0CIDDAFCR68WMC"
   #[35WMX] 2025/04/13 21:15:25 WARNING: Syncthing should not run as a privileged or system user. Please consider using a normal user account.

2. 确认并编辑配置文件： Syncthing 的配置文件通常位于 /用户名/.local/state/syncthing/config.xml。您可以通过以下命令确认具体路径：

   syncthing --paths

   记下 "Configuration" 对应的路径。下面以常见的 /root/.local/state/syncthing/config.xml 为例进行编辑（如果您的路径不同，请替换命令中的路径）：

   nano ~/.config/syncthing/config.xml

3. 允许远程访问 Web UI (重要！)： 找到 <gui> 标签下的 <address> 行，将其内容从 127.0.0.1:8384 修改为 0.0.0.0:8384：

   nano ~/.config/syncthing/config.xml

   <gui enabled="true" tls="false" debugging="false">
       <address>0.0.0.0:8384</address> <!-- 修改这里 -->
       <!-- user 和 password 稍后在 Web UI 中设置 -->
       <user></user>
       <password></password>
       <apikey>...</apikey>
       <theme>default</theme>
   </gui>

   按 Ctrl+X，然后按 Y 保存，最后按 Enter 确认。

   也可以使用一键命令来进行修改（需替换自己的路径）

   bash $

   sed -i 's|<address>127.0.0.1:8384</address>|<address>0.0.0.0:8384</address>|g' /root/.local/state/syncthing/config.xml

4. 启动 Syncthing 服务 (Systemd): 为了让 Syncthing 在后台持续运行并开机自启，我们使用 systemd。将 <user> 替换为您运行 Syncthing 的用户名（必须是您生成配置文件的那个用户）。

   sudo systemctl enable syncthing@<user>.service
   sudo systemctl start syncthing@<user>.service

   例如，如果您的用户名是 vpstownuser：

   sudo systemctl enable syncthing@vpstownuser.service
   sudo systemctl start syncthing@vpstownuser.service

   检查服务状态：

   systemctl status syncthing@<user>.service

   如果服务正常运行，您应该看到 Active (running) 的状态。

5. 访问 Web UI 并进行初始设置：

   • 如果配置了公网访问: 在浏览器中访问 http://<你的服务器 IP>:8384。
   • 如果使用 SSH 隧道 : 在您的 本地电脑 上打开终端，运行以下命令（将 <user> 替换为您服务器的用户名，<你的 VPS.Town 服务器 IP> 替换为实际 IP）：

     ssh -L 8384:localhost:8384 <user>@<你的 VPS.Town 服务器 IP>
     保持这个 SSH 连接处于活动状态，然后在您的 本地电脑 浏览器中访问 http://localhost:8384。这种方式更安全，无需暴露端口或修改监听地址。

   首次访问 Web UI 时，Syncthing 会提示您设置界面访问的用户名和密码。请务必设置一个强密码！

   

   点击提示框里面的 "Settings" (设置)，在 "GUI" 选项卡中设置 "GUI Authentication User" (用户名) 和 "GUI Authentication Password" (密码)，然后点击 "Save" (保存)。

   浏览器会要求您使用新凭据重新登录。

   

   至此，安装完成

#使用

下次填坑，可以参考其官方文档或移步搜索引擎。

#总结

通过以上步骤，您已成功在您的 Debian 12 VPS.Town 服务器上安装并配置了 Syncthing，并与您的本地电脑建立了一个安全、自动的文件同步通道。

Syncthing 功能强大，还支持文件版本控制、忽略规则、单向同步等高级功能，您可以进一步探索其官方文档 来满足更复杂的需求。

现在，您可以利用 Syncthing 轻松地备份服务器数据、在多设备间保持文件一致，享受去中心化同步带来的便利和安全性。

#VPS.Town 大盘鸡 + JuiceFS + MiniIO = 无限扩展存储空间

#准备工作

1. 服务器
   • server-A: VPS Town 大盘鸡
   • server-B: 任意其他 vps (例如，VPS.Town 传家宝)
2. 软件工具
   • MinIO
   • Juicefs
   • Redis
   • docker/podman
   • docker-compose/podman-compose