[{"content":" 📊 硬件与操作系统 操作系统: Debian GNU/Linux 13 (trixie) 内核版本: 6.12.38+deb13-amd64 CPU: AMD EPYC-Milan Processor (8 核) 内存: 7.7 GiB Total 磁盘空间: 99 GiB (根分区 /) 🌐 网络架构 (Dual-Stack) 本服务器为原生 IPv6-Only VPS，通过系统级 Cloudflare WARP (WireGuard) 实现了双栈出站能力：\neth0 (原生网卡): 分配了 /80 IPv6 地址段，负责所有原生 IPv6 出站与入站连接。 warp (WireGuard 接口): 分配了 WARP 内部 IPv4 (172.16.0.2/32)，系统策略路由将所有 IPv4 出站流量（0.0.0.0/0）自动导向 WARP，实现免费、安全、防封禁的 IPv4 访问。 🔒 系统安全基线 (Admin: admin) 超级管理员: admin（具有免密 Sudo 提权权限） Root SSH 登录: 禁用（已完成安全收口） 密码认证: 禁用（仅允许 SSH Ed25519 密钥认证） 反代与节点白名单: 后端端口段 25774:25800 及 25781 已授权 2001:db8::1 及 2001:db8::2 网页读取偏好: 普通网页优先使用 https://r.jina.ai/ 抓取；但 .md Markdown 原生文件/URL 直接读取，不经过 Jina 防护机制: UFW 防火墙启用 + Fail2ban 防爆破开启 📦 部署服务清单 服务名称 监听端口 项目目录 访问方式 / 说明 Komari Monitor 25774 /opt/komari/ Systemd 原生服务 (探针面板) Miniflux (RSS 阅读器) 25775 /opt/rss/ Docker Compose 栈 (自托管 RSS) RSSHub 1200 (内网) /opt/rss/ Docker Compose 栈 (RSS 路由) NewsNow 25776 /opt/newsnow/ Docker Compose 栈 (实时热闻) Obsidian Web 25777 /opt/obsidian/ Docker Compose 栈 (云端知识库) OpenList Web UI 25778 /opt/openlist/ Docker Compose 栈 (AIO 聚合网盘 Web) OpenList S3 网关 25779 /opt/openlist/ Docker Compose 栈 (S3 API 网关) SearXNG 25780 /opt/searxng/ Docker Compose 栈 (无限次搜索对接 Hermes) MirrorProxy 镜像站 25781 /opt/mirrorproxy/ Docker Compose 栈 (Rust 高性能软件源镜像) OmniRoute AI 网关 20128 /root/.omniroute/ 开源 AI 统一网关 (v3.8.48+ / 290+ 厂商) Hermes Agent - /root/.hermes/ AI Agent 自动化工作台 (SearXNG+Jina 黄金组合) Kopia CLI - /root/kopia/ 系统备份工具 (全量 8 大服务与快照已激活) ","permalink":"https://sb.stuinx.de/posts/guide-00/","summary":"系统运行情况与架构概览 - 架构、部署与最佳实践","title":"系统运行情况与架构概览"},{"content":" ⚙️ 概览 本服务器已成功初始化并连接 Kopia 快照存储库，并完成了首次全量加密增量备份。\n备份工具: Kopia v0.23.1 加密算法: AES256-GCM-HMAC-SHA256 + BLAKE2B-256 压缩算法: ZSTD (已全域生效) 存储路径: /mnt/backups/kopia-repo 异地备份节点: sb.stuinx.de (backup.example.com:\u0026lt;SSH_PORT\u0026gt;, SSH免密密钥认证) 异地存储路径: backup-server:~/backups/fl_server/ 自动化脚本: /root/kopia/backup-all.sh + /root/kopia/sync-to-remote.sh 定时任务: Crontab 每周一凌晨 02:00 自动运行全量增量快照并异地同步 📦 已包含的增量快照列表 (Snapshot Targets) /opt/rss (Miniflux + RSSHub + PostgreSQL 数据库) /opt/newsnow (NewsNow 热闻应用) /opt/obsidian (Obsidian Web 容器数据) /opt/openlist (OpenList 配置文件与 SQLite 数据库) /opt/searxng (SearXNG 搜索引擎配置) /mnt/obsidian/vault (Markdown 云端知识库) 📜 常用控制命令 1. 手动触发全量备份 /root/kopia/backup-all.sh 2. 查看所有快照历史 export KOPIA_PASSWORD=\u0026#34;\u0026lt;YOUR_BACKUP_PASSWORD\u0026gt;\u0026#34; kopia snapshot list 3. 数据恢复 (Restore) export KOPIA_PASSWORD=\u0026#34;\u0026lt;YOUR_BACKUP_PASSWORD\u0026gt;\u0026#34; # 格式: kopia snapshot restore \u0026lt;快照ID\u0026gt; \u0026lt;恢复目标路径\u0026gt; kopia snapshot restore k51992f995bac5b89cf53c56392755cdb /tmp/restore_rss_test/ ","permalink":"https://sb.stuinx.de/posts/guide-08/","summary":"Kopia 自动化服务器全量增量备份指南 - 架构、部署与最佳实践","title":"Kopia 自动化服务器全量增量备份指南"},{"content":" 🎯 备份方案设计 本系统使用 Kopia CLI (v0.23.1) 进行轻量、高压缩率（ZSTD）且加密的安全本地增量快照备份。\n📦 备份目标清单 /opt/rss (Miniflux + RSSHub) /opt/newsnow (NewsNow) /opt/obsidian (Obsidian Web) /opt/openlist (OpenList AIO 网盘) /opt/searxng (SearXNG 搜索引擎) /mnt/obsidian/vault (Obsidian 云端Markdown知识库) /root/hermes-backup (Hermes Agent 轻量配置与技能库) 🔒 备份凭据与存储库信息 存储库路径: /mnt/backups/kopia-repo 存储库访问密码: \u0026lt;YOUR_BACKUP_PASSWORD\u0026gt; 全量备份脚本: /root/kopia/backup-all.sh Hermes 资产备份脚本: /root/kopia/backup-hermes.sh 定时任务: Crontab 每周一凌晨 2点 自动备份 (0 2 * * 1) ⚡ 灾难快速恢复 4 步 SOP 如果 VPS 重装系统，请按以下步骤快速恢复整个服务与 Hermes Agent：\n步骤 1：安装 Docker 与 Kopia # 1. 安装 Docker curl -fsSL https://get.docker.com | bash # 2. 下载与安装 Kopia curl -L https://github.com/kopia/kopia/releases/download/v0.18.2/kopia_0.18.2_linux_amd64.tar.gz | tar -xz mv kopia-0.18.2-linux-amd64/kopia /usr/local/bin/ 步骤 2：连接备份仓库 export KOPIA_PASSWORD=\u0026#34;\u0026lt;YOUR_BACKUP_PASSWORD\u0026gt;\u0026#34; kopia repository connect filesystem --path=/mnt/backups/kopia-repo 步骤 3：一键还原所有服务与数据 # 查看快照列表 kopia snapshot list # 还原各个服务 kopia snapshot restore \u0026lt;SNAPSHOT_ID_RSS\u0026gt; /opt/rss kopia snapshot restore \u0026lt;SNAPSHOT_ID_NEWSNOW\u0026gt; /opt/newsnow kopia snapshot restore \u0026lt;SNAPSHOT_ID_OBSIDIAN\u0026gt; /opt/obsidian kopia snapshot restore \u0026lt;SNAPSHOT_ID_OPENLIST\u0026gt; /opt/openlist kopia snapshot restore \u0026lt;SNAPSHOT_ID_SEARXNG\u0026gt; /opt/searxng kopia snapshot restore \u0026lt;SNAPSHOT_ID_VAULT\u0026gt; /mnt/obsidian/vault kopia snapshot restore \u0026lt;SNAPSHOT_ID_HERMES\u0026gt; /root/.hermes 步骤 4：重启所有 Compose 栈与服务 cd /opt/rss \u0026amp;\u0026amp; docker compose up -d cd /opt/newsnow \u0026amp;\u0026amp; docker compose up -d cd /opt/obsidian \u0026amp;\u0026amp; docker compose up -d cd /opt/openlist \u0026amp;\u0026amp; docker compose up -d cd /opt/searxng \u0026amp;\u0026amp; docker compose up -d # 重启 Hermes 服务 hermes gateway restart ","permalink":"https://sb.stuinx.de/posts/guide-13/","summary":"VPS 重装与灾难快速恢复指南 - 架构、部署与最佳实践","title":"VPS 重装与灾难快速恢复指南"},{"content":" ⚙️ 架构概览 (无额度焦虑的黄金组合) Hermes Agent 默认的 Nous Portal 搜索仅有 500 次/月免费额度，极易耗尽。\n本配置采用了**“搜索用 SearXNG/DDGS 无限搜 + 抓取全文用 Jina Reader / Tavily 动额度”**的黄金解耦架构，彻底告别搜索额度焦虑：\n功能环节 选用服务 / 后端 优势与额度 主模型 (Chat) DeepSeek Chat / V4 Flash 速度极快，推理精准，性价比最高 网络搜索 (Web Search) SearXNG (searxng) 自建无限次、零费用、100% 隐私不追踪 网页全文抓取 (Fetch Content) Jina Reader (https://r.jina.ai/) 自动提取 Clean Markdown，已注入 API Key (500 RPM / 1000 万免费 Token) 搜索引擎备用 (Backup) Tavily Search 1,000 次/月免费备用 语音合成 (TTS) Edge TTS (edge-tts) 完全免费，零成本极自然发音 🛠️ 关键配置一览 ~/.hermes/config.yaml # 1. 核心模型 model: default: deepseek-chat provider: deepseek base_url: https://api.deepseek.com # 2. 网络搜索配置 (使用本机的 SearXNG 隐私搜索引擎 - 无限次) web: backend: searxng searxng_url: http://localhost:25780 use_gateway: false ~/.hermes/.env # Jina Reader API Key (500 RPM 网页全文抓取) JINA_API_KEY=\u0026lt;YOUR_JINA_API_KEY\u0026gt; # SearXNG 本地基址 SEARXNG_URL=http://localhost:25780 🚀 启动与运行 # 重启后台 Gateway 服务，应用最新搜索配置 hermes gateway restart ","permalink":"https://sb.stuinx.de/posts/guide-14/","summary":"Hermes Agent 高性能低成本 AI 工作台配置指南 (SearXNG + Jina Reader 黄金组合) - 架构、部署与最佳实践","title":"Hermes Agent 高性能低成本 AI 工作台配置指南 (SearXNG + Jina Reader 黄金组合)"},{"content":" ⚙️ 概览 OmniRoute (v3.8.50) 是一款强劲的开源 AI 统一网关（Free AI Gateway）。它将全球 290+ 厂商 / 500+ 模型（含 90+ 免费层、每月约 15.3 亿免费 Token 额度）聚合为单一 OpenAI / Claude / Gemini 兼容 API 端点，支持无感知自动降级与智能路由。\n版本: OmniRoute v3.8.48+ (release/v3.8.50 架构) 后端 API 端口: 20128 (http://localhost:20128/v1) 控制面板 Dashboard: http://localhost:20128 底层压缩管道: RTK + Caveman 压缩 (平均节省 15%~95% Token 消耗) 支持客户端: Hermes Agent, OpenClaw, Claude Code, Cursor, Cline, Antigravity, Codex 等 🚀 核心架构与路由模式 OmniRoute 提供了 19 种高可用智能路由策略：\nauto (默认开箱即用模式): 零配置自动路由，结合 12 维实时评分自动在免费池、免费额度与付费 API 间做无缝 Failover 降级。 auto/coding: 编程专用调优模式 (优先匹配高质量代码模型)。 auto/fast: 延迟优先模式。 auto/cheap: 成本优先模式。 auto/smart: 探索模式 (10% 权重测试最新模型)。 💻 常用 CLI 控制指令 # 1. 查看 OmniRoute 运行状态与检测到的本地 AI 工具 (如 Hermes) omniroute status # 2. 交互式对话测试 (使用 auto 零配置智能路由) omniroute chat \u0026#34;Hello! Introduce yourself.\u0026#34; # 3. 开启服务 / 重启服务 omniroute serve --daemon omniroute restart # 4. 一键为客户端工具注入配置 (如为 Hermes / Claude Code / Codex 生成 Config) omniroute setup-claude omniroute setup-codex omniroute setup-opencode 🌐 结合 Nginx 反向代理配置模板 (ous VPS) 可以在反代服务器 ous 的 /etc/nginx/conf.d/omniroute.conf 中配置（可映射端口 25781 或直接转发至 20128）：\nserver { listen 80; listen [::]:80; server_name route.rxm.xyz; return 301 https://$host$request_uri; } server { listen 443 ssl; listen [::]:443 ssl; http2 on; server_name route.rxm.xyz; ssl_certificate /var/www/ssl/de_GWD.cer; ssl_certificate_key /var/www/ssl/de_GWD.key; location / { proxy_pass http://[2a01:4f9:6b:4a8f:6c::e]:20128; 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_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; # 支持长连接对话与流式 SSE 响应 proxy_buffering off; proxy_read_timeout 3600; } } ","permalink":"https://sb.stuinx.de/posts/guide-15/","summary":"OmniRoute — 聚合 290+ AI 厂商与 90+ 免费额度的开源 AI 统一网关指南 - 架构、部署与最佳实践","title":"OmniRoute — 聚合 290+ AI 厂商与 90+ 免费额度的开源 AI 统一网关指南"},{"content":" ⚙️ 概览与运行状态 Hermes Agent 已成功配置并启动 Telegram Gateway 机器人常驻后台服务！\nTelegram Bot Token: `\u0026lt;YOUR_TELEGRAM_BOT_TOKEN\u0026gt; 允许访问的 User ID: \u0026lt;YOUR_TELEGRAM_USER_ID\u0026gt; (仅您个人拥有调用与交互权限，防止他人误用) 服务运行状态: active (running) via Systemd User Service (hermes-gateway.service) 开机自启: 已开启 (Linger 已激活) 🛠️ 已生效的环境变量配置 (/root/.hermes/.env) # ============================================================================= # TELEGRAM BOT INTEGRATION ACTIVE CONFIG # ============================================================================= TELEGRAM_BOT_TOKEN=\u0026lt;YOUR_TELEGRAM_BOT_TOKEN\u0026gt; TELEGRAM_ALLOWED_USERS=\u0026lt;YOUR_TELEGRAM_USER_ID\u0026gt; 🚀 常用服务控制指令 # 1. 查看 Telegram Gateway 网关运行状态 hermes gateway status # 2. 重启 Telegram 网关服务 hermes gateway restart # 3. 停止 / 启动网关服务 hermes gateway stop hermes gateway start # 4. 查看系统日志 journalctl --user -u hermes-gateway.service -f 💬 体验说明 现在您可以打开 Telegram，找到您的 Bot 机器人对话框，直接发送文本、代码问题、任务指令或语音文件，Hermes Agent 将自动在后台通过本机的 OmniRoute 网关 进行智能解答与回复！\n","permalink":"https://sb.stuinx.de/posts/guide-16/","summary":"Hermes Agent 对接 Telegram Bot 配置指南 - 架构、部署与最佳实践","title":"Hermes Agent 对接 Telegram Bot 配置指南"},{"content":" ⚙️ 核心架构 Hermes Agent 的 Gateway 架构原生支持多平台并发集成。\n您可以在同一个 hermes-gateway.service 守护进程中同时启用多个通讯平台。所有平台共享同一个 AI 核心脑（DeepSeek / OmniRoute）、跨平台持久记忆（Memory）、上下文压缩以及 40+ 内置工具能力。\n🌐 支持并发集成的通讯平台清单 ┌──────────────────────────────────────────────────────────┐ │ Hermes Gateway 核心 │ ├─────────────┬─────────────┬─────────────┬────────────────┤ │ Telegram │ Discord │ WhatsApp │ Slack │ ├─────────────┼─────────────┼─────────────┼────────────────┤ │ QQ 机器人 │ 微信 │ MS Teams │ Email (邮箱) │ └─────────────┴─────────────┴─────────────┴────────────────┘ 🔑 常用平台配置模板 (/root/.hermes/.env) 只需在 /root/.hermes/.env 文件中取消注释并填入对应平台的凭据，然后运行 hermes gateway restart 即可：\n1. Telegram (已激活) TELEGRAM_BOT_TOKEN=\u0026lt;YOUR_TELEGRAM_BOT_TOKEN\u0026gt; TELEGRAM_ALLOWED_USERS=\u0026lt;YOUR_TELEGRAM_USER_ID\u0026gt; 2. Discord 机器人 获取途径: Discord Developer Portal 创建 Bot 并开启动态 Intent DISCORD_BOT_TOKEN=MTI0... DISCORD_ALLOWED_USERS=123456789012345678 3. WhatsApp 支持通过内置 Baileys 桥接器直接扫码对接到您的 WhatsApp 账号 WHATSAPP_ENABLED=true WHATSAPP_ALLOWED_USERS=8613800138000 4. Slack 机器人 获取途径: Slack App Portal 开启 Socket Mode SLACK_BOT_TOKEN=xoxb-... SLACK_APP_TOKEN=xapp-... SLACK_ALLOWED_USERS=U12345678 5. Email (电子邮件 IMAP / SMTP) 自动监听新邮件并回复（如 Gmail 应用专用密码）： EMAIL_ADDRESS=yourname@gmail.com EMAIL_PASSWORD=xxxx xxxx xxxx xxxx EMAIL_IMAP_HOST=imap.gmail.com EMAIL_IMAP_PORT=993 EMAIL_SMTP_HOST=smtp.gmail.com EMAIL_SMTP_PORT=587 EMAIL_ALLOWED_USERS=yourname@gmail.com 🚀 配置文件更新后生效方法 每次编辑完 /root/.hermes/.env 后，只需在终端执行一次重启：\nhermes gateway restart ","permalink":"https://sb.stuinx.de/posts/guide-17/","summary":"Hermes Agent 多通讯平台同时对接指南 - 架构、部署与最佳实践","title":"Hermes Agent 多通讯平台同时对接指南"},{"content":" ⚙️ 概览 rig（项目：X-Zero-L/rig）是一款轻量级的开荒与开发环境管理框架。它通过统一的抽象屏蔽了 Debian/Ubuntu、CentOS/RHEL、Fedora、Arch Linux 及 macOS 等操作系统的差异，支持一键安装、更新、导出与卸载各类 Shell 工具、语言运行时、基础设施及 AI 编程助手。\nCLI 可执行文件位置: /root/.local/bin/rig 应用配置文件与导出格式: JSON / secrets.env 📜 命令语法结构 rig 的基本语法如下：\nrig \u0026lt;subcommand\u0026gt; [options] 子命令 说明 示例 status 查看当前系统各项组件的安装与配置状态 rig status install 启动交互式 TUI 选单或按预设安装组件 rig install\nrig install --preset agent\nrig install --all update 更新已安装的工具与组件 rig update --all uninstall 卸载特定或全部软件组件 rig uninstall --components docker\nrig uninstall --all --yes export 将当前环境配置导出为 JSON 配置文件 rig export \u0026gt; rig-config.json import 从 JSON 配置文件恢复/迁移开发环境 rig import rig-config.json self-update 升级 rig CLI 工具本身 rig self-update 📦 支持管理的核心组件列表 ├── 基础环境 (Shell \u0026amp; Tools) │ ├── shell (Zsh, Starship 提示符) │ ├── tmux (Terminal 复用器) │ ├── git (版本控制) │ └── essential-tools (rg, fd, bat, jq, gh 命令行瑞士军刀) ├── 语言运行时 (Runtimes) │ ├── node (Node.js via nvm) │ ├── uv (Python 环境与包管理) │ └── go (Go 语言环境 via goenv) ├── 基础设施 (Infrastructure) │ ├── docker (Docker \u0026amp; Docker Compose) │ ├── tailscale (虚拟局域网 Mesh VPN) │ └── ssh (SSH 安全加固) └── AI 编程助手 (AI Tools) ├── claude-code (Claude Code CLI) ├── codex (Codex CLI) ├── gemini (Gemini CLI) └── skills (Agent Skills 技能库) 🚀 常见使用场景实战 1. 查看环境状态 rig status 执行后会输出表格，清晰标出每个组件的安装状态（✔ 已安装，✘ 未配置，◐ 部分配置）。\n2. 预设快捷安装 (Presets) 不用逐个勾选组件，可直接选择预设批处理：\n# 仅安装基础 Shell + CLI 常用工具 rig install --preset minimal # 仅安装基础设施 (Docker, SSH 加固, Tailscale) rig install --preset devops # 全量一键安装 rig install --preset fullstack 3. 环境快照导出与跨机器迁移 在旧服务器导出：\nrig export 这会生成 rig-config.json（保存安装的项目列表）和 secrets.env（保存环境变量/Key，自动设为 600 权限）。\n在新服务器一键导入恢复：\nrig import rig-config.json 4. 精准卸载与清理 # 查看有哪些组件支持卸载 rig uninstall --list # 仅卸载特定的组件 (如 Docker) rig uninstall docker # 卸载特定组件并清理其持久化数据 rig uninstall docker --remove-docker-data # 无交互模式一键卸载全部组件 rig uninstall --all --yes 🌐 镜像与代理支持 (国内 VPS 加速) 若在网络受限环境或国内 VPS 上使用，可在命令前加 --gh-proxy 参数或环境变量：\n# 环境变量方式 export GH_PROXY=\u0026#34;https://gh-proxy.org\u0026#34; rig status # 命令参数方式 rig install --gh-proxy https://gh-proxy.org ","permalink":"https://sb.stuinx.de/posts/guide-18/","summary":"rig 开发环境配置与管理工具全功能使用指南 - 架构、部署与最佳实践","title":"rig 开发环境配置与管理工具全功能使用指南"},{"content":" ⚙️ 概览 MirrorProxy 是一款基于 Rust 编写的高性能自托管镜像代理平台。内嵌 React 管理控制台，支持对 GitHub、Docker/OCI、语言包仓库（npm、PyPI、Go、Cargo 等）以及操作系统软件源（Debian、Ubuntu、Fedora、Arch Linux 等）进行代理转发、缓存、配额管理与流量统计。\n版本: MirrorProxy latest (kudang/mirrorproxy:latest) 后端监听端口: 25781 部署目录: /opt/mirrorproxy 默认管理员账号: admin 默认管理员密码: \u0026lt;YOUR_ADMIN_PASSWORD\u0026gt; 🛠️ 部署架构与配置文件 配置文件路径: /opt/mirrorproxy/config.toml\nDocker 编排文件: /opt/mirrorproxy/docker-compose.yml\nlisten_addr = \u0026#34;0.0.0.0:3000\u0026#34; database_path = \u0026#34;/data/mirrorproxy.sqlite3\u0026#34; public_base_url = \u0026#34;http://localhost:25781\u0026#34; forward_client_authorization = false enabled_proxies = [ \u0026#34;github\u0026#34;, \u0026#34;composer\u0026#34;, \u0026#34;oci\u0026#34;, \u0026#34;npm\u0026#34;, \u0026#34;nvm\u0026#34;, \u0026#34;go\u0026#34;, \u0026#34;maven\u0026#34;, \u0026#34;rustup\u0026#34;, \u0026#34;crates\u0026#34;, \u0026#34;pypi\u0026#34;, \u0026#34;homebrew\u0026#34;, \u0026#34;os\u0026#34; ] [upstreams] github = \u0026#34;https://github.com\u0026#34; github_raw = \u0026#34;https://raw.githubusercontent.com\u0026#34; docker_hub = \u0026#34;https://registry-1.docker.io\u0026#34; ghcr = \u0026#34;https://ghcr.io\u0026#34; npm = \u0026#34;https://registry.npmjs.org\u0026#34; go_proxy = \u0026#34;https://proxy.golang.org\u0026#34; pypi_simple = \u0026#34;https://pypi.org/simple\u0026#34; pypi_files = \u0026#34;https://files.pythonhosted.org\u0026#34; debian = \u0026#34;https://deb.debian.org/debian\u0026#34; ubuntu = \u0026#34;https://archive.ubuntu.com/ubuntu\u0026#34; 🌐 代理服务调用 URL 格式 当服务绑定在 25781 端口后，可以通过以下 URL 代理拉取资源：\nGitHub Raw 文件代理： http://localhost:25781/gh/owner/repo/main/file.txt Docker / OCI 镜像代理： http://localhost:25781/v2/ npm 镜像代理： npm config set registry http://localhost:25781/npm/ PyPI 镜像代理： pip install -i http://localhost:25781/pypi/simple/ package_name 🚀 服务管理指令 # 查看容器状态 cd /opt/mirrorproxy \u0026amp;\u0026amp; docker compose ps # 查看日志 cd /opt/mirrorproxy \u0026amp;\u0026amp; docker compose logs -f # 重启 MirrorProxy cd /opt/mirrorproxy \u0026amp;\u0026amp; docker compose restart ","permalink":"https://sb.stuinx.de/posts/guide-19/","summary":"MirrorProxy 跨平台镜像代理平台部署指南 - 架构、部署与最佳实践","title":"MirrorProxy 跨平台镜像代理平台部署指南"},{"content":"本文档全面梳理了针对 de_GWD（旁路网关与服务端代理系统）的深度架构剖析、痛点改造方案及全协议矩阵演进蓝图。\n本指南涵盖 主线路升级、多协议管理中心（选项 5）、内网反向穿透（选项 6）、HAProxy 多中转（选项 44） 以及 Cloudflare WARP 防失联重构（选项 33，参考 fscarmen/warp-sh） 的完整技术落地规范。\n1. 架构改造总览与菜单映射 重构后的 Server 端主菜单严格契合官方原生色彩、排版韵律与交互用词，同时完成了各功能模块的“关注点分离（Separation of Concerns）”：\nNginx [ ✓ ] Xray [ ✓ ] DoH serverr [ ✓ ] AutoUpdate [ ✓ ] kvm Version: 2.x [Enabled] Cloudflare wireguard upstream (WARP) [Enabled] HAProxy TCP Port Forward [Enabled] Rproxy Server ---------------------------------------------------------------- Debian Version: 12 (bookworm) Kernel: 6.1.0-xx-amd64 ---------------------------------------------------------------- SSL certificate expires on: $sslExpireDate ============SERVER============================================== Require: Debian (amd64 \u0026amp;\u0026amp; arm64) Author: JacyL4 ================================================================ 1. Install de_GWD 2. Install new kernel and reboot 3. Change domain and generate new certificate 4. Change Xray path \u0026amp; UUID \u0026lt;-- 保持不变: 专门维护主线路 5. Set Multi-Protocol \u0026lt;-- 优化新增: Xray 原生多协议中心 (CYAN) 6. Set Rproxy Server \u0026lt;-- 优化新增: 内网穿透服务管理 (CYAN) 0. Update de_GWD 00.AutoUpdate turn on/off 11.Print Xray node information \u0026lt;-- 联动升级: 智能打印全部已开节点 12.Localhost cloudflare speedtest 33.Set Cloudflare wireguard upstream (WARP) \u0026lt;-- 优化重构: 模式B (fscarmen防失联) 44.Set TCP Port Forward \u0026lt;-- 优化重构: HAProxy 多条并发中转 CTRL+C EXIT 2. 主出网线路演进：默认安装 VLESS-WS-TLS 2.1 改造思路（安装即迁移） 彻底弃用老旧的 VMess 协议作为主干。在执行选项 1（Install de_GWD）或升级时，直接初始化为 VLESS + WebSocket + TLS：\nCPU 开销下降 30%~40%：去除 VMess 冗余加密，数据由底层 TLS 1.3 原生保护； 解决断联容错：免除 VMess 严格的 90 秒 NTP 时间同步限制； 无缝复用现有架构：100% 复用 Nginx 反代入口、*.rxm.xyz 泛域名证书（/var/www/ssl/de_GWD.cer）以及端口（2096 / 443）。 2.2 选项 4（Change Xray path \u0026amp; UUID）职责不变 专职负责修改主线路 VLESS-WS 的伪装路径（如 /fc5289）与主 UUID，不与扩展协议混淆。 3. 选项 5：Set Multi-Protocol（Xray 原生多协议中心） 选项 5 收敛了 Xray-core 原生支持的高频核心协议，按需启闭，采用极简命名：\n================================================ [1]: VLESS-REALITY-Vision [2]: VLESS-TLS-Vision [3]: VMess-WS [4]: Shadowsocks [5]: Socks5 [6]: HTTP [7]: Dokodemo [0]: Back ================================================ 3.1 协议技术规格与证书策略表 协议名称 底层协议组合 端口策略 SSL 证书策略 核心定位 [1] VLESS-REALITY-Vision VLESS + TCP + REALITY + Vision 独立高位端口 (如 8443) 免证书 (偷取苹果/微软权威 SNI) 公网直连防封之王，免维护自建证书，内核零拷贝透传。 [2] VLESS-TLS-Vision VLESS + TCP + TLS + Vision 独立高位端口 (如 9443) 复用主线泛域名证书 (de_GWD.cer) 合法自持证书直连巅峰，结合 Vision 流控跑满物理带宽。 [3] VMess-WS VMess + WebSocket + TLS 场景 3: 独立域名 + 独立端口 复用主线泛域名证书 (de_GWD.cer) 老旧客户端向后兼容，老软路由/老设备专属保底。 [4] Shadowsocks Shadowsocks-2022 / AEAD 独立端口 (如 10086) 无需证书 极简对称加密，适合国内专线/中转机对接落地。 [5] Socks5 Socks5 (auth: password, UDP: on) 独立端口 (如 10808) 无需证书 通用标准代理，供 Telegram、脚本、游戏加速使用。 [6] HTTP HTTP Proxy (auth: password) 独立端口 (如 10809) 无需证书 开发环境专用，供 Linux 终端、curl、Docker 环境变量调用。 [7] Dokodemo Dokodemo-door (TCP/UDP) 独立端口 (如 2201) 无需证书 轻量运维跳板，专用于中转其他 VPS 的 SSH / 纯 IPv6 机器。 3.2 场景 3 专项落地：VMess-WS 老客户端兼容 为了绝对不干扰主干线路，在添加 [3] VMess-WS 时采用场景 3（独立域名 + 独立端口）：\n交互输入：提示输入独立子域与端口（例如 legacy.rxm.xyz:8443）； Xray Inbound：在 /opt/de_GWD/vtrui/config.json 注入 tag: \u0026quot;vmess-compat-in\u0026quot;，监听本地 127.0.0.1:9895，按原版规则截取 UUID 后 6 位生成路径； Nginx 独立配置：生成独立文件 /etc/nginx/conf.d/vmess_compat.conf，直接引用主线泛域名证书： server { listen 8443 ssl http2; server_name legacy.rxm.xyz; ssl_certificate /var/www/ssl/de_GWD.cer; ssl_certificate_key /var/www/ssl/de_GWD.key; location /fc5289 { proxy_pass http://127.0.0.1:9895; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection \u0026#34;upgrade\u0026#34;; } } 防火墙联动：自动检测并执行 ufw allow 8443/tcp。 4. 选项 6：Set Rproxy Server（内网反向穿透系统） 4.1 核心定位与架构解耦 将官方客户端归档中遗留的 RproxyS 正式迁移为 Server 端顶级独立服务：\n进程独立：由专属 RproxyS.service 守护，配置文件独立为 /opt/de_GWD/RproxyS/config.json； 故障隔离：穿透连接抖动或家庭端重连，主出网网关 vtrui 零重启、零感知。 4.2 架构与流量流程 [ 外部访客 (nas.rxm.xyz:2096) ] │ ▼ [ Nginx 泛域名反代 ] (终结 TLS，解密流量) │ proxy_pass: 127.0.0.1:15000 ▼ ┌──────────────────────────────────────────────────────────┐ │ VPS RproxyS 独立实例 │ │ ├── Dokodemo-door 入站 (监听 15000) │ │ ├── 路由规则: inboundTag -\u0026gt; \u0026#34;portal\u0026#34; │ │ └── Reverse Portal (反向长连接隧道) │ └─────────────────────────────▲────────────────────────────┘ │ │ 反向 WebSocket/TLS 隧道 │ (家庭内网主动自内向外握手) ┌─────────────────────────────▼────────────────────────────┐ │ 家庭内网端 RproxyC (旁路由) │ │ ├── Reverse Bridge │ │ └── Freedom 出站 (重定向至 192.168.1.100:5000 NAS) │ └──────────────────────────────────────────────────────────┘ [!TIP] 证书全面继承 外部所有映射子域名（如 nas.rxm.xyz）全部由 Server 端 Nginx 统合托管，直接复用 /var/www/ssl/de_GWD.cer，家庭内网所有服务对外统一享受 HTTPS 绿锁，公网零开放杂乱高位端口。\n5. 选项 44 优化：HAProxy 多条大流量中转 5.1 原版痛点 原版 changeTCPPF 每次设置都会无脑 cat \u0026gt; /etc/haproxy/haproxy.cfg 覆盖配置文件，导致系统只能维护 1 条中转，无法满足多节点中继需求。\n5.2 优化方案：规则持久化与动态编译 数据存储：将每条中转规则以 JSON 数组形式保存在 /etc/haproxy/rules.json： [ { \u0026#34;id\u0026#34;: 1, \u0026#34;localPort\u0026#34;: 10443, \u0026#34;target\u0026#34;: \u0026#34;hk-node.xyz:443\u0026#34;, \u0026#34;desc\u0026#34;: \u0026#34;香港落地\u0026#34; }, { \u0026#34;id\u0026#34;: 2, \u0026#34;localPort\u0026#34;: 10444, \u0026#34;target\u0026#34;: \u0026#34;jp-node.xyz:443\u0026#34;, \u0026#34;desc\u0026#34;: \u0026#34;日本落地\u0026#34; } ] 动态编译生成：遍历 JSON 数组，动态拼装追加多个 frontend 与 backend 段落，通过 haproxy -c 语法检查后 systemctl reload haproxy 平滑热生效； 职责划分清爽： 选项 44（HAProxy）：专职负责大流量、高并发的科学代理节点中转； 选项 5-7（Dokodemo）：专职负责轻量运维跳板与 VPS 登录中继。 6. 选项 33 优化：Cloudflare WARP 模式 B（fscarmen 防失联架构） 6.1 彻底抛弃原版全局覆盖路由 原版直接设置 AllowedIPs = 0.0.0.0/0, ::/0，直接篡改 Linux main 默认路由表，导致外部 SSH 握手回包被错投进 WARP 虚拟网卡，造成 VPS 瞬间断网成砖，且原版显式拒绝纯 IPv6 机器。\n6.2 引入 fscarmen/warp-sh 的四重防失联铁律（模式 B） # /etc/wireguard/wgcf.conf [Interface] PrivateKey = \u0026lt;WARP_PRIVATE_KEY\u0026gt; Address = 172.16.0.2/32 Address = 2606:4700:110:8xxx::/128 DNS = 1.1.1.1 MTU = 1280 # === 吸收 fscarmen 防失联核心策略路由 === # 1. 锁定当前 SSH 客户端 IP，优先走 main 表原路回包 PostUp = ip -4 rule add to ${SSH_CLIENT_IPV4} lookup main pref 99 2\u0026gt;/dev/null || true PostUp = ip -6 rule add to ${SSH_CLIENT_IPV6} lookup main pref 99 2\u0026gt;/dev/null || true # 2. 锁定 VPS 真实公网物理 IP，进出流量原路返回 PostUp = ip -4 rule add from ${REAL_IPV4} lookup main pref 100 2\u0026gt;/dev/null || true PostUp = ip -6 rule add from ${REAL_IPV6} lookup main pref 100 2\u0026gt;/dev/null || true # 3. 隔离 WARP 默认出站至专属独立路由表 51820 Table = 51820 PostUp = ip -4 rule add not fwmark 51820 table 51820 pref 1000 PostUp = ip -6 rule add not fwmark 51820 table 51820 pref 1000 # 4. 退出清理 (PostDown 同步撤销规则) PostDown = ip -4 rule del to ${SSH_CLIENT_IPV4} lookup main pref 99 2\u0026gt;/dev/null || true PostDown = ip -6 rule del from ${REAL_IPV4} lookup main pref 100 2\u0026gt;/dev/null || true PostDown = ip -4 rule del not fwmark 51820 table 51820 pref 1000 2\u0026gt;/dev/null || true [Peer] PublicKey = \u0026lt;WARP_PUBLIC_KEY\u0026gt; Endpoint = \u0026lt;WARP_ENDPOINT_IP\u0026gt;:2408 AllowedIPs = 0.0.0.0/0 AllowedIPs = ::/0 PersistentKeepalive = 15 6.3 带来的质变 0% 失联率：四重策略路由保证 SSH 和 Nginx 原生连接绝对不断； 纯 IPv6 机器一键拯救：纯 IPv6 VPS 自动启用 WARP IPv4 模块，无痛获得全局访问 IPv4 能力； 集成流媒体/AI 刷新 IP：支持一键轮换 Cloudflare Endpoint，自动刷到能解锁 ChatGPT / Netflix 的干净 IP。 7. 选项 11 节点导出聚合升级 在主菜单选择 11. Print Xray node information 时，终端智能感知已激活的协议并聚合输出：\n-------------------------------------------------- Node Information DoH: ous.rxm.xyz:2096/dq Address: ous.rxm.xyz:2096 UUID: e8d7f6c5-b4a3-4210-9876-543210abcdef Path: /fc5289 (VLESS-WS 主干) [✓] VLESS-REALITY-Vision: 8443 (SNI: www.apple.com) [✓] VLESS-TLS-Vision: ous.rxm.xyz:9443 [✓] VMess-WS (Legacy): legacy.rxm.xyz:8443 (/fc5289) [✓] Shadowsocks: 10086 (aes-256-gcm) [✓] Socks5: 10808 (auth: on) [✓] Dokodemo Relay: 2201 -\u0026gt; 2600:1900:xxx:22 [✓] Cloudflare WARP: IPv4: 104.28.xxx.xxx | IPv6: 2a09:xxx:xxx QR code: [二维码区域] -------------------------------------------------- 8. 总结 本指导文件为 de_GWD 的二次开发与生产级重构建立了坚实的工程标准：\n主线强韧：以 VLESS-WS 为盾，以 VLESS-REALITY 为矛； 穿透自洽：RproxyS 与 Nginx 泛域名结合，打造免端口暴露的内网穿透； 中转清晰：44 掌管高并发数据面，5-7 掌管轻量运维控制面； WARP 安全：吸收 fscarmen 防失联路由算法，兼具系统双栈补全与流媒体解锁能力。 ","permalink":"https://sb.stuinx.de/posts/guide-21/","summary":"de_GWD 架构现代化改造与全协议优化实施指南 - 架构、部署与最佳实践","title":"de_GWD 架构现代化改造与全协议优化实施指南"},{"content":"tmux（Terminal Multiplexer）是一个终端复用工具，允许在一个终端窗口中创建、访问和控制多个终端会话，并在后台保持会话持续运行（即使断开 SSH 连接，程序也会继续运行）。\n1. 核心概念 tmux 的结构分为三个层级：\nSession（会话）：一个独立的任务环境，断开连接后仍保持运行。 Window（窗口）：会话中的“标签页”，占据整个终端屏幕。 Pane（窗格）：窗口切分出的子区域，可以在同一屏幕上并行看多个终端。 [!NOTE] 快捷键前缀（Prefix Key） 在 tmux 中，绝大多数快捷键都需要先按 Ctrl + b，松开后再按对应功能键。\n2. 会话（Session）管理 系统终端命令 操作 命令 新建会话 tmux 新建具名会话 tmux new -s \u0026lt;session-name\u0026gt; 查看所有会话 tmux ls 重新连接会话 tmux a -t \u0026lt;session-name\u0026gt; （a 即 attach） 连接上一次会话 tmux a 杀掉指定会话 tmux kill-session -t \u0026lt;session-name\u0026gt; 杀掉所有会话 tmux kill-server tmux 会话内部快捷键（先按 Ctrl + b） d ：分离（Detach）当前会话，回到系统终端（后台程序不受影响） $ ：重命名当前会话 s ：选择/切换其他会话列表 3. 窗口（Window）管理 在同一个 tmux 会话中可以创建多个窗口（标签页）：\nCtrl + b 后按 c：新建窗口（Create） Ctrl + b 后按 ,：重命名当前窗口 Ctrl + b 后按 n：切换到下一个窗口（Next） Ctrl + b 后按 p：切换到上一个窗口（Previous） Ctrl + b 后按 0~9：按数字直接跳转对应窗口 Ctrl + b 后按 w：展开显示所有窗口列表并进行选择 Ctrl + b 后按 \u0026amp;：关闭当前窗口 4. 窗格（Pane）管理 将单个窗口切分成多个并行区域：\n拆分与关闭 Ctrl + b 后按 %：垂直分屏（左右分割） Ctrl + b 后按 \u0026quot;：水平分屏（上下分割） Ctrl + b 后按 x：关闭当前窗格 Ctrl + b 后按 z：最大化/恢复当前窗格（切换全屏） 切换与调整 Ctrl + b 后按 方向键：光标移动到邻近窗格 Ctrl + b 后按 ;：在上次使用的两个窗格间切换 Ctrl + b 后按 o：顺时针轮换到下一个窗格 Ctrl + b 后按 Alt + 方向键：按像素调整当前窗格大小 Ctrl + b 后按 Space：循环切换预设的窗格布局 5. 复制与滚动模式（Copy Mode） Ctrl + b 后按 [：进入滚动/复制模式 使用 PageUp / PageDown 或 方向键 上下滚动浏览历史输出。 按 Space（或 v）开始选择文本，按 Enter（或 y）复制所选文本。 按 q 退出复制模式。 Ctrl + b 后按 ]：粘贴复制的内容。 6. 常用推荐配置（~/.tmux.conf） 可以通过创建或编辑用户目录下的 ~/.tmux.conf 文件来开启鼠标支持、调整历史行数等：\n# 开启鼠标支持（支持鼠标点击切换窗格、拖拽调整大小、滚轮滚动） set -g mouse on # 增加历史滚动行数 set -g history-limit 10000 # 开启 256 色支持 set -default-terminal \u0026#34;screen-256color\u0026#34; # 重新加载配置文件的快捷键：Ctrl+b r bind r source-file ~/.tmux.conf \\; display-message \u0026#34;Config reloaded..\u0026#34; 加载配置生效：\ntmux source ~/.tmux.conf ","permalink":"https://sb.stuinx.de/posts/guide-20/","summary":"tmux 终端复用工具全功能使用指南 - 架构、部署与最佳实践","title":"tmux 终端复用工具全功能使用指南"}]