Jielumoon's Blog

GitHub 记忆同步：AI 助手的异地备份方案

Sun, 01 Mar 2026 00:00:00 GMT

核心目标：为 AI 助手箱宝实现记忆的异地版本化备份，防止 VPS 数据丢失，同时为未来迁移到 PVE 小主机做准备。

缘起：为什么需要记忆同步？#

箱宝是我的 OpenClaw AI 助手，拥有完整的”记忆系统”：

短期记忆：memory/YYYY-MM-DD.md — 每日对话日志
长期记忆：MEMORY.md — curated 重要决策和上下文
档案：memory/archive/ — 归档的旧日记

风险点：

VPS 故障可能导致记忆数据丢失
未来迁移到 PVE 小主机时需要完整迁移记忆
需要版本控制追踪记忆变更历史

解决方案：使用 GitHub 私有仓库进行异地备份，通过 Cron 定时自动推送。

一、仓库准备#

1.1 创建私有仓库#

在 GitHub 创建私有仓库 xiangbao-memory：

Terminal window

1
# 仓库信息
2
- URL: https://github.com/Jielumoon/xiangbao-memory
3
- 可见性：Private（记忆含敏感上下文）
4
- 初始化：不添加 README（本地已有完整内容）

1.2 生成 GitHub PAT#

创建 Personal Access Token（Fine-grained 或 Classic 均可）：

Terminal window

1
# 权限需求
2
- repo (Full control of private repositories)
3
# 或者 Fine-grained:
4
- Contents: Read and write

⚠️ 安全警告：PAT 必须保存在安全位置，不要提交到 Git 历史！

二、本地 Git 配置#

2.1 初始化仓库#

在 OpenClaw workspace 目录初始化 Git：

Terminal window

1
cd /root/.openclaw/workspace
2

3
# 配置 Git 用户（箱宝的身份！）
4
git config --global user.name "箱宝"
5
git config --global user.email "xiangbao@openclaw.ai"
6

7
# 初始化仓库
8
git init
9

10
# 添加远程仓库（使用 PAT）
11
git remote add origin https://ghp_YOUR_PAT_HERE@github.com/Jielumoon/xiangbao-memory.git

2.2 配置 .gitignore（关键！）#

⚠️ 血泪教训：首次提交时误追踪了大量敏感文件，包括：

docker/cli-proxy/auths/ — 900+ 个 API 凭证 JSON
docker/ds2api-runtime/config.json — API Key
backup/*.tar.gz — 大型备份文件（触发 GitHub LFS 警告）
.trash/ — 临时删除文件

正确的 .gitignore 配置：

1
# 敏感凭证
2
**/auths/*.json
3
**/secrets/*.json
4
**/*.env
5

6
# 大型文件
7
backup/*.tar.gz
8
backup/*.zip
9
media/outbound/*.png
10
media/outbound/*.jpg
11

12
# 临时文件
13
.trash/
14
tmp/
15
*.log
16

17
# 系统文件
18
.DS_Store
19
Thumbs.db
20

21
# 其他 Git 仓库（避免嵌套）
22
blog/.git
23
skills/*/.git

显示更多显示更少

2.3 首次提交#

Terminal window

1
# 添加所有文件
2
git add .
3

4
# 检查是否有大文件（>50MB 会警告）
5
git status
6

7
# 提交
8
git commit -m "🧠 初始化箱宝记忆备份 2026-02-28"
9

10
# 推送
11
git branch -M main
12
git push -u origin main

三、敏感文件清理（如果已误提交）#

如果像箱宝一样不小心提交了敏感文件，需要彻底清理：

3.1 从 Git 历史移除（不删除本地文件）#

Terminal window

1
# 移除已追踪的敏感目录
2
git rm --cached -r docker/cli-proxy/auths/
3
git rm --cached -r backup/
4

5
# 提交清理
6
git commit -m "🔒 移除敏感文件：cpa 凭证、ds2api 配置、备份文件"
7

8
# 强制推送（⚠️ 会重写历史）
9
git push -f origin main

3.2 如果已推送到 GitHub#

⚠️ 严重警告：即使 git push -f，敏感文件仍然存在于 GitHub 历史中！

正确做法：

立即更换泄露的 API Key / PAT
使用 git filter-branch 或 BFG Repo-Cleaner 彻底清理历史
或者：删除仓库重新创建（箱宝的选择）

四、Cron 自动化同步#

4.1 创建同步脚本#

/root/.openclaw/workspace/scripts/memory-sync.sh显示更多显示更少

1
#!/bin/bash
2

3
set -e
4

5
WORKSPACE="/root/.openclaw/workspace"
6
cd "$WORKSPACE"
7

8
# 检查是否有变更
9
if git status --porcelain | grep -q .; then
10
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 检测到记忆变更，开始同步..."
11

12
    # 添加变更
13
    git add memory/ MEMORY.md
14

15
    # 提交（如果有变更）
16
    if ! git diff --staged --quiet; then
17
        git commit -m "📦 自动同步记忆 $(date '+%Y-%m-%d %H:%M')"
18
        git push origin main
19
        echo "[$(date '+%Y-%m-%d %H:%M:%S')] 同步完成"
20
    else
21
        echo "[$(date '+%Y-%m-%d %H:%M:%S')] 无记忆变更，跳过提交"
22
        git reset
23
    fi
24
else
25
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 工作区干净，无需同步"
26
fi

显示更多显示更少

4.2 配置 Cron 任务#

Terminal window

1
# 编辑 crontab
2
crontab -e
3

4
# 添加每日同步任务（每天 02:00）
5
0 2 * * * /root/.openclaw/workspace/scripts/memory-sync.sh >> /var/log/memory-sync.log 2>&1

4.3 OpenClaw 内置 Cron（可选）#

OpenClaw 自身也有记忆同步 Cron，配置在 openclaw.json：

1
{
2
  "cron": {
3
    "jobs": [
4
      {
5
        "name": "memory-sync",
6
        "schedule": "0 10,14,18,22 * * *",
7
        "text": "openclaw sessions sync --to diary"
8
      }
9
    ]
10
  }
11
}

区别：

OpenClaw Cron：会话 → 日记文件（内部同步）
Git Cron：日记文件 → GitHub（异地备份）

推荐：两者都用，形成完整链路 ✅

五、安全最佳实践#

5.1 PAT 安全管理#

Terminal window

1
# ✅ 正确做法
2
- 使用 Fine-grained PAT（限制权限范围）
3
- 设置过期时间（如 90 天）
4
- 保存在安全位置（密码管理器、加密文件）
5
- 定期轮换
6

7
# ❌ 错误做法
8
- PAT 明文写在脚本里
9
- 提交 PAT 到 Git 历史
10
- 使用永不过期的 Classic PAT

5.2 .gitignore 检查清单#

在首次推送前，务必检查：

Terminal window

1
# 检查是否有大文件
2
git ls-files -s | awk '{if ($3 > 52428800) print $4}'
3

4
# 检查是否有敏感文件
5
find . -name "*.json" -path "*/auths/*"
6
find . -name "config.json" -path "*/docker/*"
7
find . -name "*.env"

5.3 提交前审查#

Terminal window

1
# 查看将要提交的内容
2
git status
3
git diff --staged
4

5
# 如果有不确定的文件
6
git ls-files --others --exclude-standard

六、恢复与迁移#

6.1 从 GitHub 恢复记忆#

如果 VPS 数据丢失，可以从 GitHub 恢复：

Terminal window

1
# 克隆仓库
2
git clone https://github.com/Jielumoon/xiangbao-memory.git /root/.openclaw/workspace
3

4
# 恢复记忆文件
5
cp -r memory/ /root/.openclaw/workspace/
6
cp MEMORY.md /root/.openclaw/workspace/

6.2 迁移到新环境#

迁移到 PVE 小主机时：

Terminal window

1
# 1. 在新环境克隆仓库
2
git clone https://github.com/Jielumoon/xiangbao-memory.git /root/.openclaw/workspace
3

4
# 2. 配置 Git 远程（如果需要继续同步）
5
git remote set-url origin https://ghp_NEW_PAT@github.com/Jielumoon/xiangbao-memory.git
6

7
# 3. 验证记忆完整性
8
ls -la memory/
9
cat MEMORY.md | head -20

七、成本与限制#

7.1 GitHub 免费额度#

项目	限制	箱宝使用情况
私有仓库	无限	✅
单文件大小	100MB（硬限制）	✅ 记忆文件 <1MB
仓库总大小	1GB（软限制）	✅ 当前 ~50MB
带宽	100GB/月	✅ 同步频率低

7.2 潜在问题#

大文件警告：单个文件 >50MB 会警告，>100MB 拒绝
- 解决：.gitignore 排除 backup/*.tar.gz
Git 历史膨胀：频繁提交大文件会导致仓库膨胀
- 解决：只追踪 memory/ 和 MEMORY.md
敏感信息泄露：误提交 API Key
- 解决：提交前审查 + .gitignore 严格配置

八、效果与监控#

8.1 同步日志#

查看同步日志：

Terminal window

1
tail -f /var/log/memory-sync.log

示例输出：

1
[2026-03-01 02:00:01] 检测到记忆变更，开始同步...
2
[2026-03-01 02:00:03] 同步完成

8.2 GitHub 提交历史#

访问仓库查看提交历史：

1
https://github.com/Jielumoon/xiangbao-memory/commits/main

可以看到：

每次同步的时间
变更的文件
提交消息（含日期）

总结#

核心收获#

异地备份：记忆数据不再依赖单一 VPS
版本控制：可以回溯任意时间点的记忆状态
迁移便利：未来搬迁到 PVE 只需 git clone
自动化：Cron 每日同步，无需手动干预

关键教训#

先配 .gitignore 再 git add — 顺序不能反！
敏感文件绝不提交 — 一旦提交就要重写历史
PAT 定期轮换 — 安全永远是第一位

下一步优化#

添加同步失败告警（Telegram 通知）
压缩记忆文件后再推送（减少带宽）
双向同步（GitHub → 本地，防止本地误删）

参考资源#

发布时间：2026 年 3 月 1 日
系列：AI 助手定制实践

FRP 内网穿透：用 VPS 远程访问家里的 NAS

Thu, 22 Jan 2026 00:00:00 GMT

折腾 Homelab 的最后一块拼图：在外面也能访问家里的 NAS

为什么需要内网穿透？#

家里的 fnOS 跑着各种服务，但运营商给的是内网 IP，从外面访问不了。解决方案有几种：

方案	优点	缺点
DDNS + 端口映射	简单	需要公网IP，运营商可能不给
Tailscale/ZeroTier	零配置	依赖第三方，国内速度一般
frp	自主可控，速度取决于VPS	需要有VPS
WireGuard	性能最好	配置稍复杂

正好手上有阿里云 VPS，frp 是最顺手的选择。

架构设计#

graph LR A["🌐 外网设备 (手机/电脑)"] -->|访问| B["☁️ 阿里云 VPS frps 服务端"] B -->|穿透| C["🏠 家庭内网 frpc 客户端"] C --> D["📦 fnOS/Docker 服务"]

穿透目标：

fnOS 管理界面 (5666)
SSH (22)
其他 Docker 服务

VPS 端：部署 frps#

1. 下载 frp#

Terminal window

1
# 在 VPS 上执行
2
cd /opt
3
wget https://github.com/fatedier/frp/releases/download/v0.61.1/frp_0.61.1_linux_amd64.tar.gz
4
tar -xzf frp_0.61.1_linux_amd64.tar.gz
5
mv frp_0.61.1_linux_amd64 frp

2. 配置 frps.toml#

/opt/frp/frps.toml

1
bindPort = 7000
2
auth.token = "你的安全密钥"
3

4
# Web 管理面板（可选）
5
webServer.addr = "0.0.0.0"
6
webServer.port = 7500
7
webServer.user = "admin"
8
webServer.password = "你的面板密码"

3. 创建 systemd 服务#

/etc/systemd/system/frps.service

1
[Unit]
2
Description=frp server
3
After=network.target
4

5
[Service]
6
Type=simple
7
ExecStart=/opt/frp/frps -c /opt/frp/frps.toml
8
Restart=on-failure
9
RestartSec=5s
10

11
[Install]
12
WantedBy=multi-user.target

Terminal window

1
systemctl daemon-reload
2
systemctl enable frps
3
systemctl start frps

4. 开放防火墙端口#

Terminal window

1
# 阿里云安全组需要放行以下端口
2
# 7000 - frp 通信端口
3
# 7500 - frp 管理面板（可选）
4
# 6000-6100 - 穿透服务端口段

内网端：部署 frpc#

方案一：Docker 部署（推荐）#

在 fnOS 上用 Docker 运行 frpc：

docker-compose.yml

1
version: '3'
2
services:
3
  frpc:
4
    image: snowdreamtech/frpc
5
    container_name: frpc
6
    restart: always
7
    network_mode: host
8
    volumes:
9
      - ./frpc.toml:/etc/frp/frpc.toml

frpc.toml显示更多显示更少

1
serverAddr = "47.108.xxx.xxx"
2
serverPort = 7000
3
auth.token = "你的安全密钥"
4

5
[[proxies]]
6
name = "fnos-web"
7
type = "tcp"
8
localIP = "127.0.0.1"
9
localPort = 5666
10
remotePort = 6001
11

12
[[proxies]]
13
name = "fnos-ssh"
14
type = "tcp"
15
localIP = "127.0.0.1"
16
localPort = 22
17
remotePort = 6022

显示更多显示更少

方案二：IStoreOS 插件#

如果想在路由器层面做穿透，IStoreOS 有 frpc 插件可以直接装。

验证与使用#

Terminal window

1
# 外网访问 fnOS 管理界面
2
http://47.108.xxx.xxx:6001
3

4
# 外网 SSH 连接
5
ssh -p 6022 user@47.108.xxx.xxx

安全加固#

内网穿透等于把内网服务暴露到公网，安全措施必须到位：

强密码 + 改默认端口
frp 启用 token 认证
考虑加一层 Nginx 反向代理 + HTTPS
敏感服务可以用 STCP（需要访问端也装 frpc）

避坑清单#

问题	原因	解决
连接超时	VPS 安全组没开端口	检查阿里云安全组规则
frpc 启动失败	token 不匹配	检查两端配置一致性
穿透后访问慢	VPS 带宽瓶颈	换更高带宽的 VPS
服务时断时续	frpc 没设置重连	用 systemd/Docker 托管

实战：NAT VPS 的特殊配置#

上面是标准的独立 IP VPS 配置。但如果你用的是 NAT VPS（共享公网 IP，通过端口映射访问），配置会有些不同。

NAT VPS vs 独立 IP VPS#

对比项	独立 IP VPS	NAT VPS
公网 IP	独享一个	多用户共享
端口使用	任意端口	只能用分配的端口
价格	较贵	便宜（常见 10-30 元/月）
访问方式	`IP:端口`	`域名:映射端口`

NAT VPS 通常会给你一个域名和几个端口映射，比如：

1
内部端口 33895 → 外部 xxxxxx.xxxxx.xxx:43155
2
内部端口 3000  → 外部 xxxxxx.xxxxx.xxx:58619

我的实际架构#

graph LR A["🌐 外网设备"] -->|":43155"| B["☁️ NAT VPS frps 监听 :33895"] B <-->|隧道| C["🖥️ PVE LXC CFtunnel"] C -->|"10.0.0.191:3000"| D["🔧 NewAPI"] style B fill:#333,stroke:#666,stroke-width:2px,color:#fff style C fill:#333,stroke:#666,stroke-width:2px,color:#fff

VPS 端配置（NAT 版）#

/opt/frp/frps.toml

1
# 注意：bindPort 要用 NAT 分配的内部端口
2
bindPort = 33895
3
auth.token = "你的安全密钥"

关键点：bindPort 填的是 NAT 内部端口，不是外部端口。

内网端配置（PVE LXC 容器）#

我选择在 PVE 的 LXC 容器里跑 frpc，而不是 Docker，更轻量。

1. 下载 frp#

Terminal window

1
# 国内服务器建议用镜像加速
2
cd /opt
3
wget https://mirror.ghproxy.com/https://github.com/fatedier/frp/releases/download/v0.61.1/frp_0.61.1_linux_amd64.tar.gz
4
tar -xzf frp_0.61.1_linux_amd64.tar.gz
5
mv frp_0.61.1_linux_amd64 frp
6

7
# 重要：给执行权限！
8
chmod +x /opt/frp/frpc

2. 配置 frpc.toml#

/opt/frp/frpc.toml

1
# serverPort 要填 NAT 的外部端口！
2
serverAddr = "xxxxxx.xxxxx.xxx"
3
serverPort = 43155
4
auth.token = "你的安全密钥"
5

6
[[proxies]]
7
name = "newapi"
8
type = "tcp"
9
localIP = "10.0.0.191"    # 内网服务的实际 IP
10
localPort = 3000
11
remotePort = 3000         # VPS 上暴露的端口

NAT VPS 的坑：

serverAddr 填域名，不是 IP
serverPort 填外部映射端口（43155），不是 frps 的 bindPort（33895）
remotePort 也要在 NAT 端口映射范围内，否则外网访问不到

3. 创建 systemd 服务#

/etc/systemd/system/frpc.service

1
[Unit]
2
Description=frp client
3
After=network.target
4

5
[Service]
6
Type=simple
7
ExecStart=/opt/frp/frpc -c /opt/frp/frpc.toml
8
Restart=on-failure
9
RestartSec=5s
10

11
[Install]
12
WantedBy=multi-user.target

Terminal window

1
systemctl daemon-reload
2
systemctl enable frpc
3
systemctl start frpc

验证连接#

Terminal window

1
# 检查 frpc 状态
2
systemctl status frpc
3

4
# 外网访问穿透的服务
5
# 如果 remotePort=3000 映射到外部 58619
6
curl http://xxxxxx.xxxxx.xxx:58619

NAT VPS 避坑补充#

问题	原因	解决
frpc 启动报 `permission denied`	二进制文件没有执行权限	`chmod +x /opt/frp/frpc`
连接成功但外网访问不了	remotePort 不在 NAT 映射范围	检查 NAT 端口分配
GitHub 下载卡住	国内网络问题	用 ghproxy 镜像
serverPort 填错	NAT 有内外端口之分	frpc 填外部端口，frps 填内部端口

关于 HTTPS#

通过 frp 穿透后，访问链接是 http://域名:端口，浏览器会提示”不安全”。

几种解决思路：

Cloudflare 代理 - 免费 HTTPS，但会增加延迟
Nginx + Let’s Encrypt - 在 VPS 上套一层反代
frp 的 HTTPS 插件 - frp 原生支持，但配置稍复杂
不管它 - 自己用的服务，HTTP 也无所谓

frp 用了这么多年还是香，配置简单，稳定可靠。NAT VPS 虽然便宜，但端口映射确实要多绕一步。搞清楚内外端口的关系，剩下的就顺理成章了。

N150小主机搭建小型数据中心：PVE虚拟化+单线多拨+容器NewAPI

Thu, 18 Dec 2025 00:00:00 GMT

系统目标达成：经过数天的调试与优化，从PVE虚拟化环境到IStoreOS网关的多拨配置，再到fnOS上NewAPI的稳定部署，整个系统最终实现了预期的功能与性能目标。

缘起：为什么要折腾这套系统？#

此前使用旧笔记本运行Docker服务，但设备老化导致风扇噪音明显，功耗较高。为获得更稳定的运行环境与更低的长期运行成本，在双12期间配置了一台基于Intel N150平台的小主机。

系统目标：

基础服务：NAS + Docker容器（24小时运行）
主路由功能：替代运营商提供的默认网关
全局代理分流：基于OpenClash
多模型API聚合：部署NewAPI服务

核心架构：基于PVE的虚拟化部署，实现资源隔离与功能模块化

硬件篇#

1
CPU: Intel N150
2
  核心: 4核4线程
3
  TDP: 6W
4

5
内存: 8GB DDR4
6
  通道: 单通道
7
  备注: 计划升级至16GB
8

9
存储:
10
  系统盘: 256GB NVMe
11

12
网络:
13
  WAN口: enp2s0 (直通IStoreOS)
14
  LAN口: enp3s0 (内部交换)
15
  规格: 双2.5GbE

显示更多显示更少

该配置在性能与功耗间取得了较好的平衡，能够满足当前及可预见未来的应用需求。

PVE虚拟化：从零开始#

安装PVE#

PVE的安装过程遵循标准流程：下载官方ISO镜像、制作启动介质、引导安装。关键配置在于存储分区，建议将系统盘全部划归PVE管理，数据磁盘可在后续阶段挂载，以保持配置的灵活性。

创建虚拟机#

IStoreOS (网关)

1
类型: Linux 6.x - 2.6内核
2
CPU: 2核
3
内存: 1GB
4
硬盘: 8GB (精简配置)
5
网络:
6
  - vmbr0 (WAN): 网卡直通给IStoreOS
7
  - vmbr1 (LAN): 连内部交换机

fnOS (NAS)

1
类型: Linux 6.x - 2.6内核
2
CPU: 3核 (给Docker预留)
3
内存: 4GB (balloon动态调节)
4
硬盘: 64GB + 额外挂载SATA硬盘
5
网络: vmbr1 (LAN)

两个系统

IStoreOS：单线多拨配置与解决方案#

配置周期：约三天时间，期间进行了多次配置迭代与调试。

基础网络配置#

完成常规PPPoE拨号设置，配置LAN口IP为192.168.1.1，确保基础路由功能正常。

多拨配置过程#

第一阶段：插件安装与虚拟网卡配置#

需要安装两个核心插件：

macvlan – 创建虚拟网卡
mwan3 – 实现流量负载均衡

1
# 在IStoreOS后台操作路径
2
系统 → 软件包 → 更新软件包列表
3
安装相应包

创建虚拟网卡命令：

Terminal window

1
ip link add link enp2s0 name macvlan0 type macvlan mode bridge
2
ip link set macvlan0 up

两个系统

第二阶段：配置问题诊断与解决#

问题一：macvlan接口无法正常工作

原因分析：当前内核版本存在macvlan驱动兼容性问题
解决方案：改用VLAN子接口替代

Terminal window

1
ip link add link enp2s0 name enp2s0.10 type vlan id 10

问题二：mwan3负载均衡配置复杂

1
# 关键配置 /etc/config/mwan3
2
config member 'wan_m1'
3
    option interface 'wan'
4
    option weight '1'
5
    option reliability '2'  # reliability参数设置为2时连接最为稳定

问题三：代理分流与DNS泄露

现象：开启OpenClash后部分网络请求未能通过代理（参见之前博客文章）
原因分析：多拨配置后mwan3接管了虚拟网卡流量，DNS解析请求绕过透明代理机制
解决方案：配置iptables例外规则

Terminal window

1
# 在IStoreOS中执行
2
iptables -t mangle -A mwan3_hook -p tcp --dport 23456 -j RETURN
3
iptables -t mangle -A mwan3_hook -p udp --dport 53 -j RETURN

最终可用配置#

网络配置#

/etc/config/network

1
config interface 'wan'
2
    option proto 'pppoe'
3
    option ifname 'enp2s0'
4
    option username '你的账号'
5
    option password '你的密码'
6
    option dns '119.29.29.29 223.5.5.5'
7

8
config interface 'wan2'
9
    option proto 'pppoe'
10
    option ifname 'macvlan0'  # 或者是你用的vlan子接口
11
    option username '你的账号'
12
    option password '你的密码'

OpenClash配置（局域网代理）#

1
# 给局域网设备开放代理
2
config rule
3
    option dest_port '23456'
4
    option src_ip '192.168.1.0/24'
5
    option target 'REJECT'
6

7
# DNS防泄露
8
dns:
9
  enable: true
10
  nameserver:
11
    - 119.29.29.29
12
  fallback:
13
    - tls://8.8.8.8:853
14
  fallback-filter:
15
    geoip: true

显示更多显示更少

最终效果：物理带宽从100M提升至300M以上，视频流媒体与API调用响应时间显著改善。

fnOS：轻舟NAS部署#

网络正确配置后，fnOS部署过程相对顺利，主要包含以下步骤：

1. 网络配置确认#

确保fnOS虚拟机正确配置：

IP地址: 192.168.1.200 (静态)
网关: 192.168.1.1 (指向IStoreOS)
DNS: 192.168.1.1 (IStoreOS处理DNS解析)

2. Docker环境配置#

由于fnOS自带Docker服务，无需额外配置镜像加速器。通过fnOS后台即可管理容器：

1
# 操作路径
2
fnOS后台 → 容器 → 设置
3

4
# 备注：由于OpenClash已配置代理，无需设置国内镜像加速

3. 目录结构准备#

Terminal window

1
# 创建基础目录结构
2
mkdir -p /volume1/docker/{newapi,postgres,backup}

整体配置流程较为简单，fnOS自带的Docker管理界面足够满足基础需求。

代理闭环的思考#

设计目标不仅是实现NewAPI的正常访问，更需要在安全性与性能之间建立平衡：

1
NewAPI的请求路径:
2
容器 → fnOS网卡 → vmbr1交换 → IStoreOS的Clash → 根据规则:
3
  - OpenAI/Anthropic → 代理 → 国外
4
  - 文心/千问 → 直连 → 国内
5
  - 域名解析: 全走Clash的DNS

网络架构遵循功能分离原则，网关专注于路由与代理分流，NAS负责存储与容器服务，各组件职责明确。

备份策略#

系统部署完成后，需要建立灾难恢复机制，确保在故障情况下能够快速恢复。

1
# 在PVE Shell添加crontab，每周日凌晨执行
2
#!/bin/bash
3
/root/backup-pve.sh
4

5
DATE=$(date +%Y%m%d)
6
STORAGE="/mnt/backups/pve"
7

8
# 备份VM
9
qm backup 100 $STORAGE/istoreos-$DATE.vma.zst --mode snapshot
10
qm backup 101 $STORAGE/fnos-$DATE.vma.zst --mode snapshot
11

12
# 清理老备份（只保留最近3份）
13
find $STORAGE -name "*.vma.zst" -mtime +21 -delete

NAS上的重要数据，则通过rsync同步到外接硬盘。

监控与扩展#

系统稳定后，我发现还需要监控能力，又在fnOS上装了几个容器：

1
# 监控全家桶（可选）
2
services:
3
  netdata:
4
    image: netdata/netdata
5
    ports: ["19999:19999"]
6
    privileged: true
7

8
  portainer:
9
    image: portainer/portainer-ce
10
    ports: ["9000:9000"]
11
    volumes: ["/var/run/docker.sock:/var/run/docker.sock"]

避坑清单#

问题	原因	解决方案
PVE虚拟机卡启动	网卡配置错误	检查vmbr桥接配置
多拨掉线	DNS污染导致连接不稳定	清理DNS缓存，修改mwan3配置
Docker连不上DB	容器网络与数据库不在同一subnet	确认使用相同bridge network
OpenClash日志为空	代理模式设置不当	改为”规则模式”而非”全局模式”
NAS磁盘写入权限	Docker映射目录权限问题	指定用户ID或调整目录owner权限

最终成果#

N150小主机：功耗平均8W，全年不到60元电费
IStoreOS网关：稳定多拨6个会话，带宽翻倍
fnOS NAS：Docker服务稳定运行，NewAPI调用响应及时
代理分流：国内应用不受影响，国外服务稳定加速

Next steps：

接入媒体服务（Jellyfin）
加WireGuard异地访问
完善监控告警

如果你也在用N150或者PVE虚拟化，欢迎交流经验

该系统实现了预期的功能整合，在单台硬件设备上运行多项服务，在成本控制与功能完备性间取得了良好平衡。

注: 本文涉及的命令与配置均在生产环境实际测试，使用相关命令与配置时，请结合自身网络环境进行调整与验证。

《重构》读后感：改善代码质量的实践指南

Sat, 22 Nov 2025 00:00:00 GMT

《重构》读后感：改善代码质量的实践指南#

最近读完了 Martin Fowler 的经典著作《重构：改善既有代码的设计》，这是一本每个程序员都应该阅读的技术书籍。本书不仅系统地介绍了重构的概念和方法，更重要的是提供了一套实用的重构技术体系。

📚 书籍概览#

《重构》这本书的核心理念是：通过一系列小的、保持行为的转换，逐步改善代码的设计。Fowler 在书中详细阐述了什么是重构、为什么需要重构，以及如何进行重构。

核心观点#

重构的定义：重构是一种对软件内部结构的改善，目的是在不改变软件可观察行为的前提下，使其更易理解和修改。
重构的时机：不是等到代码腐烂不堪时才重构，而是在添加功能、修复 bug、代码审查时持续进行。
重构的步骤：小步快跑，每次只做微小的改动，确保测试通过后再进行下一步。

🔍 重构的基本原则#

1. 保持行为不变#

重构的第一要务就是确保代码的外部行为不会改变。这意味着：

所有现有的功能测试都应该继续通过
用户看不到任何差异
API 接口保持不变

2. 小步前进#

不要试图一次性做大规模的重构，而是：

每次只做一个微小的改动
每步都要运行测试
频繁提交代码

3. 消除代码坏味道#

Fowler 在书中总结了多种”代码坏味道”，包括：

重复代码：相同的代码出现在多个地方
过长函数：函数体过大，难以理解和维护
过大的类：类承担了过多的责任
过长参数列表：函数参数过多
发散式变化：一个类因为多种原因需要修改
霰弹式修改：一个修改需要在多个类中进行

🛠️ 常用重构技术#

书中介绍了 60 多种具体的重构技术，这里分享几个最常用和实用的：

1. 提炼函数（Extract Method）#

1
// 重构前
2
function printOwing(amount) {
3
  printBanner();
4
  console.log("name:", name);
5
  console.log("amount:", amount);
6
}
7

8
// 重构后
9
function printOwing(amount) {
10
  printBanner();
11
  printDetails(amount);
12
}
13

14
function printDetails(amount) {
15
  console.log("name:", name);
16
  console.log("amount:", amount);
17
}

显示更多显示更少

2. 内联函数（Inline Method）#

与提炼函数相反，当函数体过于简单时，可以将其内联到调用处。

3. 提炼变量（Extract Variable）#

1
// 重构前
2
if (platform.toUpperCase().indexOf("MAC") > -1 &&
3
    browser.toUpperCase().indexOf("IE") > -1) {
4
  // do something
5
}
6

7
// 重构后
8
const isMacOs = platform.toUpperCase().indexOf("MAC") > -1;
9
const isIEBrowser = browser.toUpperCase().indexOf("IE") > -1;
10
if (isMacOs && isIEBrowser) {
11
  // do something
12
}

4. 引入参数对象（Introduce Parameter Object）#

当一组参数总是一起出现时，可以将它们封装成一个对象。

5. 拆分循环（Split Loop）#

一个循环只做一件事情，避免在一个循环中处理多个不同的逻辑。

🧪 测试驱动重构#

重构的前提是有一套可靠的测试套件。Fowler 强调：

先写测试，再重构：确保重构前的代码行为是正确的
小步重构，频繁测试：每做一点改动就运行测试
保持测试通过：如果测试失败，立即回滚或修复

💡 个人收获与实践#

读完这本书后，我在实际工作中应用重构技术，收获颇丰：

1. 代码质量显著提升#

通过持续的小步重构，代码变得更加清晰、易读、易维护。函数的粒度更合适，类的职责更加单一。

2. 开发效率提高#

虽然重构本身需要时间，但良好的代码结构让后续的功能开发和 bug 修复变得更加高效。

3. 团队协作更顺畅#

清晰的代码结构和命名让团队成员更容易理解彼此的代码，减少了沟通成本。

4. 技术债务管理#

通过持续重构，避免了技术债务的积累，不会让代码库逐渐变得难以维护。

🎯 重构的最佳实践#

基于书中的理论和我的实践经验，总结以下最佳实践：

1. 建立重构文化#

将重构视为开发过程的一部分
鼓励团队成员进行重构
在代码审查中关注重构机会

2. 工具支持#

使用 IDE 的重构功能（如 VSCode、IntelliJ 等）
配置代码质量检查工具（如 ESLint、SonarQube 等）
建立自动化测试流程

3. 渐进式重构#

不要试图一次性重构整个系统
在新功能开发时顺便重构相关代码
优先重构经常变动的代码区域

4. 文档记录#

记录重要的重构决策
分享重构经验和最佳实践
建立团队的重构指南

🤔 重构 vs 重写#

很多人会把重构和重写混淆，Fowler 在书中明确区分了两者：

重构：保持外部行为不变，逐步改善内部结构
重写：从头开始重新实现，通常会改变外部行为

重构的风险更小，成本更低，应该优先考虑重构而非重写。

📖 总结#

《重构》这本书不仅提供了系统的方法论，更重要的是建立了一种持续改进代码质量的思维方式。它让我明白：

好的代码是演进出来的，不是一开始就完美的
小步快跑比大步跳跃更安全有效
测试是重构的基石
重构应该是开发者的日常习惯

这本书值得反复阅读，每次重读都会有新的收获。强烈推荐给所有想要提高代码质量的开发者！

如果你也读过这本书，欢迎在评论区分享你的感悟和实践经验。让我们一起写出更好的代码！

关于IStoreOS单线多拨配置

Wed, 15 Oct 2025 00:00:00 GMT

关于IStoreOS单线多拨配置#

前期准备#

首先得有一台配置好IStoreOS（OpenWrt）的机器，已连接好网络，并且确定自己的账号可以多拨。

安装必要插件#

进入 系统-软件包-更新软件包

需要下载几个插件，分别是：

macvlan（用以创建虚拟网卡）
macvlan
mwan3（负载均衡-用以调节每个拨号）
mwan3

创建虚拟网卡#

安装好之后，进入 网络-接口-设备

此时需要注意一下 wan 是用的哪一个网口，虚拟网口要用一样的网口。

现在先复制一下 wan 的 MAC地址，待会有用。

点击 添加设备配置

设备类型选择 macvlan，基础设备选择 wan 所对应的网口，一般来说是eth0，我是eth1。

模式默认即可，即 VEPA

设备名自行填写即可，如果有多个拨号，不要重复

MTU默认即可，除非有特殊需要。

刚刚复制的MAC地址此时就有用了，一般来说是 12:34:56:78:90 此时直接粘贴上去，然后修改最后一位，例如：12:34:56:78:90 后续要增加虚拟接口也是一样，例如：12:34:56:78:90，注意不要相同。

IPv6最好关闭，选择已禁用。

图片如下：

图片

进入高级设置里，混杂模式有的账号需要启用才能拨号成功，有的不启用才能拨号成功，这里自行尝试，其他默认即可。

然后点击保存，保存并应用，然后接着回到接口

选择添加新接口，名称建议是vwan1，方便区别，协议选择PPPOE，设备选择你刚刚创建的那一个设备，即图上的eth1mac0

填入你的账号和密码，接着点开高级设置，获取IPv6地址选择已禁用

此时需要配置使用网关度量值，这里应该填20，那么也就是说10应该填在wan的网关度量值，后续有多个虚拟接口，往后顺延即可。

接着切换到防火墙设置，选择wan所在的防火墙，接着在DHCP服务器里点击配置DHCP服务器

然后点保存，保存并应用

过几秒刚刚配置的接口应该可以成功获取到IPv4地址，如果没有，那就试试切换刚刚说的混杂模式

配置mwan3负载均衡#

接下来配置mwan3负载均衡，这是实现多拨带宽叠加的关键步骤。

1. 进入mwan3配置界面#

进入 网络-负载均衡，点击 详细设置。

2. 配置接口#

在接口标签页中，删除所有配置,点击添加，为每个拨号接口创建mwan3接口：

wan接口配置：
- 接口名称：wan
- 跟踪IP：可以填写8.8.8.8或114.114.114.114等公共DNS
- 可靠性：1
- 间隔：1000（毫秒）
- 超时：1000（毫秒）
- 失败次数：3
- 恢复次数：3
vwan1接口配置：
- 接口名称：vwan1
- 跟踪IP：同上
- 其他参数与wan接口相同

WARNING 注意每个接口的跟踪IP不能相同。

如果有更多拨号接口，按照相同方式添加。

3. 配置成员#

切换到成员标签页，删除所有配置，为每个接口创建成员：

wan成员：
- 名称：wan_m1
- 接口：wan
- 度量值：1
- 权重：1（如果带宽相同，可以都设为1；如果带宽不同，可以按比例设置）
vwan1成员：
- 名称：vwan1_m1
- 接口：vwan1
- 度量值：1
- 权重：1

4. 配置策略#

切换到策略标签页，删除所有配置，创建负载均衡策略：

均衡策略：
- 名称：balanced
- 使用成员：wan_m1 vwan1_m1（用空格分隔）
- 策略类型：负载均衡
故障转移策略（可选）：
- 名称：failover
- 使用成员：wan_m1 vwan1_m1
- 策略类型：故障转移

5. 配置规则#

切换到规则标签页，删除所有配置，设置流量分配规则：

默认规则：
- 名称：default_rule
- 源地址：留空（表示所有源）
- 目的地址：留空（表示所有目的）
- 策略：balanced
- 启用：勾选

6. 应用配置#

点击 保存并应用，等待几秒钟让配置生效。

验证配置#

1. 检查接口状态#

在 网络-接口 页面，确认所有拨号接口都已获取到IP地址且状态为”已连接”。

2. 检查mwan3状态#

在 网络-负载均衡 页面，查看概览标签页，确认所有接口状态为”在线”。

3. 测试负载均衡#

可以通过以下方式测试负载均衡是否生效：

命令行测试：

1
mwan3 status
2
mwan3 interfaces
3
mwan3 policies

流量监控：在 网络-负载均衡-诊断 中，可以查看各接口的流量使用情况。
多线程下载测试：使用多线程下载工具（如aria2）下载大文件，观察是否多个接口都在工作。

常见问题与解决#

1. 拨号失败#

检查账号密码是否正确
尝试切换”混杂模式”设置
确认运营商是否支持多拨

2. 负载均衡不生效#

检查mwan3配置是否正确
确认所有接口状态为”在线”
检查策略和规则设置

3. 带宽未叠加#

确认所有接口都在工作
检查权重设置是否合理
使用多线程应用测试

高级配置#

1. 按流量类型分流#

可以创建不同的策略，为不同类型的流量使用不同的接口：

创建针对游戏、视频等特定应用的策略
设置规则，将特定端口或IP的流量导向特定策略

2. 时间段控制#

可以设置在不同时间段使用不同的负载均衡策略，例如：

白天使用均衡策略
夜间使用特定接口

3. 流量监控与统计#

mwan3提供了详细的流量统计功能，可以：

查看各接口实时流量
统计历史流量使用情况
设置流量告警

测试与探索：博客功能的全面体验

Tue, 14 Oct 2025 00:00:00 GMT

测试与探索：博客功能的全面体验#

博客功能测试#

1. 文本格式测试#

这是一篇测试文章，用于验证博客的各种功能。我们可以测试不同的文本格式：

无序列表项1
无序列表项2
- 嵌套列表项1
- 嵌套列表项2

有序列表项1
有序列表项2
1. 嵌套有序列表项1
2. 嵌套有序列表项2

2. 引用块测试#

人生如逆旅，我亦是行人。
这句话提醒我们，在人生的旅途中，每个人都是匆匆过客，应当珍惜当下，勇敢前行。

3. 代码块测试#

下面是一些代码示例，用于测试代码高亮功能：

1
// JavaScript示例
2
function greetUser(name) {
3
  const currentTime = new Date().toLocaleTimeString();
4
  console.log(`你好，${name}！当前时间是：${currentTime}`);
5
  return `欢迎来到我的博客，${name}！`;
6
}
7

8
// 调用函数
9
const message = greetUser("访客");

1
# Python示例
2
def fibonacci(n):
3
    """计算斐波那契数列的第n项"""
4
    if n <= 0:
5
        return 0
6
    elif n == 1:
7
        return 1
8
    else:
9
        return fibonacci(n-1) + fibonacci(n-2)
10

11
# 计算前10项
12
for i in range(10):
13
    print(f"F({i}) = {fibonacci(i)}")

4. 数学公式测试#

我们可以使用LaTeX语法来展示数学公式：

行内公式：E=mc2E = mc^2E=mc2

块级公式：

∫−∞∞e−x2dx=π\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}∫−∞∞e−x2dx=π

5. 表格测试#

功能	状态	备注
文本格式	✅ 正常	支持各种Markdown格式
图片显示	✅ 正常	支持本地和外部图片
代码高亮	✅ 正常	支持多种编程语言
数学公式	✅ 正常	基于KaTeX渲染
表格显示	✅ 正常	支持对齐和样式

6. 图片测试#

下面是一张测试图片：

测试图片

图片可以很好地融入文章内容，增强阅读体验。

警告框测试#

NOTE
这是一个普通的提示框，用于提供一般性信息。

TIP
这是一个技巧提示框，用于分享一些有用的技巧或建议。

IMPORTANT
这是一个重要信息框，用于强调重要内容。

WARNING
这是一个警告框，用于提醒用户注意潜在问题。

CAUTION
这是一个谨慎提示框，用于提醒用户谨慎操作。

链接测试#

这是一个内部链接示例，指向博客中的另一篇文章。

这是一个外部链接示例，指向我的GitHub主页。

总结#

通过这篇测试文章，我们验证了博客系统的各项功能：

✅ 文本格式化
✅ 列表和引用
✅ 代码高亮
✅ 数学公式
✅ 表格显示
✅ 图片嵌入
✅ 警告框
✅ 链接功能

这个博客系统基于Astro和Fuwari主题构建，提供了丰富的功能和良好的用户体验。如果你对博客的任何功能有疑问或建议，欢迎通过关于页面联系我。

这篇文章最后更新于2025年10月14日

欢迎来到 Jielumoon 的博客

Wed, 15 Jan 2025 00:00:00 GMT

欢迎来到我的博客！🎉#

你好！欢迎来到我的个人博客。我是 Jielumoon，很高兴在这里与你分享我的想法、经验和发现。

关于这个博客#

这个博客基于 Astro 和 Fuwari 主题构建，旨在：

📝 分享技术知识和经验
💭 记录生活感悟和思考
🚀 探索新技术和工具
🤝 与志同道合的朋友交流

你可以在这里找到什么？#

🔧 技术相关#

编程技巧和最佳实践
开发工具推荐
项目经验分享
技术趋势讨论

📚 学习笔记#

新技术学习心得
读书笔记和总结
在线课程体验

🌟 生活分享#

日常生活感悟
兴趣爱好分享
旅行见闻

联系我#

如果你对我的内容感兴趣，或者想要交流讨论，欢迎通过以下方式联系我：

GitHub: Jielumoon
Telegram: Jielumoon

最后#

感谢你访问我的博客！希望这里的内容能对你有所帮助或启发。

如果你喜欢这个博客，欢迎收藏并定期回来看看。我会持续更新有趣和有用的内容。

让我们一起在知识的海洋中探索，在技术的道路上前行！✨

这篇文章发布于 2025年1月15日

Astro 框架入门指南

Tue, 14 Jan 2025 00:00:00 GMT

Astro 框架入门指南#

Astro 是一个现代化的静态站点生成器，它专注于构建快速、内容驱动的网站。本文将为你介绍 Astro 的核心特性和基本使用方法。

🌟 为什么选择 Astro？#

1. 零 JavaScript 运行时#

Astro 默认生成纯静态 HTML，只在需要时才加载 JavaScript，这让网站加载速度极快。

2. 组件岛架构（Islands Architecture）#

你可以在静态页面中嵌入交互式组件，实现部分水合（Partial Hydration）。

3. 多框架支持#

在同一个项目中使用 React、Vue、Svelte 等不同框架的组件。

4. 内置优化#

自动进行代码分割、图片优化、CSS 压缩等性能优化。

🚀 快速开始#

安装 Astro#

Terminal window

1
# 创建新项目
2
npm create astro@latest my-astro-site
3

4
# 进入项目目录
5
cd my-astro-site
6

7
# 安装依赖
8
npm install
9

10
# 启动开发服务器
11
npm run dev

项目结构#

1
my-astro-site/
2
├── public/          # 静态资源
3
├── src/
4
│   ├── components/  # 组件
5
│   ├── layouts/     # 布局
6
│   ├── pages/       # 页面
7
│   └── styles/      # 样式
8
├── astro.config.mjs # 配置文件
9
└── package.json

📝 基本语法#

Astro 组件#

Astro 组件使用 .astro 扩展名，结合了 JavaScript 和类似 JSX 的模板语法：

1
---
2
// 组件脚本（在构建时运行）
3
const title = "Hello, Astro!";
4
const items = ["Apple", "Banana", "Cherry"];
5
---
6

7
<!-- 组件模板 -->
8
<html>
9
  <head>
10
    <title>{title}</title>
11
  </head>
12
  <body>
13
    <h1>{title}</h1>
14
    <ul>
15
      {items.map(item => <li>{item}</li>)}
16
    </ul>
17
  </body>
18
</html>

显示更多显示更少

使用其他框架组件#

1
---
2
// 导入 React 组件
3
import MyReactComponent from '../components/MyReactComponent.jsx';
4
// 导入 Vue 组件
5
import MyVueComponent from '../components/MyVueComponent.vue';
6
---
7

8
<html>
9
  <body>
10
    <!-- 静态渲染 -->
11
    <MyReactComponent />
12

13
    <!-- 客户端水合 -->
14
    <MyVueComponent client:load />
15
  </body>
16
</html>

显示更多显示更少

🎨 样式处理#

作用域样式#

1
---
2
// 组件脚本
3
---
4

5
<style>
6
  /* 自动作用域到当前组件 */
7
  h1 {
8
    color: blue;
9
  }
10
</style>
11

12
<h1>这个标题是蓝色的</h1>

全局样式#

1
<style is:global>
2
  /* 全局样式 */
3
  body {
4
    font-family: sans-serif;
5
  }
6
</style>

📄 内容管理#

Astro 内置了强大的内容管理功能，支持 Markdown 和 MDX：

src/content/config.ts

1
import { defineCollection, z } from 'astro:content';
2

3
const blog = defineCollection({
4
  type: 'content',
5
  schema: z.object({
6
    title: z.string(),
7
    description: z.string(),
8
    publishDate: z.date(),
9
    tags: z.array(z.string()).optional(),
10
  }),
11
});
12

13
export const collections = { blog };

🔧 配置和集成#

astro.config.mjs#

1
import { defineConfig } from 'astro/config';
2
import tailwind from '@astrojs/tailwind';
3
import react from '@astrojs/react';
4

5
export default defineConfig({
6
  integrations: [tailwind(), react()],
7
  site: 'https://my-site.com',
8
});

📈 性能优势#

更小的包体积：只加载必要的 JavaScript
更快的首屏加载：静态 HTML 立即可见
更好的 SEO：完全的服务端渲染
渐进式增强：按需添加交互性

🎯 适用场景#

Astro 特别适合：

📝 博客和文档网站
🛍️ 营销和展示网站
📊 仪表板和管理界面
🎨 作品集网站

总结#

Astro 是一个优秀的现代化静态站点生成器，它结合了传统静态网站的性能优势和现代前端框架的开发体验。如果你正在寻找一个快速、灵活且易于使用的解决方案来构建内容驱动的网站，Astro 绝对值得一试！

想了解更多？访问 Astro 官方文档获取详细信息。