Luyus的个人站点

Wireguard 在 Windows 中的亿点点细节

2025-12-14T16:00:00.000Z

1 Windows 杂谈

作为使用人数最多，覆盖最广的操作系统，是组网绕不开的。且不说60%的开发者使都使用Windows开发程序，很多的游戏，剪辑软件，显卡驱动都更加贴合Windows。

Linux以简洁的命令，清晰的架构，快捷的程序安装，成为了无数服务喜爱的温床。Wireguard在Linux中可以被方便的部署，配置。

多年使用Wireguard的我总结了多项Wireguard在Windows中的痛点，有了我的解决方案。

2 命令行操作

正常来看，Windows只能通过UI界面对接口进行操作，UI关闭后网络接口将会被关闭。所有配置的导入，修改，都依赖UI (ssh噩梦)。

不同于Linux有wg-quick接口控制工具，Windows只保留了最原始wg工具。但少有人知道，wireguard.exe本身不止是一个UI，还是一个命令行工具。

将Wireguard目录添加系统环境变量(默认安装时已经添加)，然后彻底关闭UI页面(再见了UI)。

安装新接口作为系统服务(后台安装，不会开启UI接口，类似与wg-quick，且重启不会丢失)

1	wireguard.exe /installtunnelservice "%CONF_PATH%"

卸载同理

1	wireguard.exe /uninstalltunnelservice "%WG_INTERFACE%"

wg 工具和 Linux 一样，包括 wg show 和 wg sync ，这里不再赘述。

3 IP转发

两者类似，但是要注意Windows要在powershell运行命令。

# Linux
sysctl -w net.ipv4.ip_forward=1

# Windows
Get-NetIPInterface
Set-NetIPInterface -Forwarding Enabled

4 跨接口转发

将Windows下Wireguard网络接口级别设置为Private

1	Set-NetConnectionProfile -InterfaceAlias "%WG_INTERFACE%" -NetworkCategory Private

启用NAT转发Wireguard流量到别的接口

1 2	# Linux New-NetNat -Name "WG-NAT" -InternalIPInterfaceAddressPrefix %WG_ALL_IPS%

等价于以下Linux命令

1	iptables -t nat -A POSTROUTING -s %WG_ALL_IPS% -o eth0 -j MASQUERADE

欢迎查看我的项目 fast_fullmesh

WGDashboard 插件,用于自动生成 WireGuard 配置(Half Mesh),客户端主动订阅配置,集中管理。

在腾讯轻量应用服务器部署gitea和runner

2025-10-14T16:00:00.000Z

gitea真的是太轻量好用啦！

1 安装gitea

1.1 准备工作

拥有一台服务器，并且拥有公网ip

我这里是采用了腾讯云的轻量应用云服务器，使用的Ubuntu并安装好了docker。这里采用docker部署。

1.2 创建目录与权限

bash

1 2	mkdir -p /srv/gitea/{data,config,logs} chown -R 1000:1000 /srv/gitea

1.3 编写`docker-compose.yml`

在 /srv/gitea/ 目录下创建 docker-compose.yml：

bash

1	sudo vi docker-compose.yml

然后根据自己的配置需求更改。这里已经使用了镜像源。

docker-compose.yml

version: "3"

networks:
  gitea:
    external: false

services:
  gitea:
    image: swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitea/gitea:1.24.3
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__server__ROOT_URL=https://gitea.xinghenluyus.cn/  #修改成自己的
      - GITEA__server__DOMAIN=gitea.xinghenluyus.cn             #修改成自己的
      - GITEA__server__SSH_DOMAIN=gitea.xinghenluyus.cn         #修改成自己的
    restart: always
    networks:
      - gitea
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"  # Web 有冲突就修改
      - "222:22"     # SSH 有冲突就修改

1.4 部署命令

bash

1 2	cd /srv/gitea sudo docker compose up -d

1.5 解析域名到服务器

这一步主要是为了开启HTTPS，配合反向代理无端口食用。

在域名控制台添加A解析到服务器，在本地电脑打开终端，运行：

bash

1	ping gitea.example.com

如果返回的ip是解析的ip，说明解析成功。

1.6 安装 Nginx

登录你的服务器，执行：

Bash

#更新包列表
sudo apt update

#安装 Nginx
sudo apt install nginx -y

#启动并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx

测试 Nginx 是否正常：

浏览器访问：gitea.example.com，看到Nginx欢迎页则说明安装成功。

1.7 创建 Nginx 配置文件(不启用 HPPTS)

创建文件

bash

1	sudo vim /etc/nginx/sites-available/gitea.xinghenluyus.cn.conf

nginx

server {
    listen 80;
    server_name gitea.xinghenluyus.cn;

    # Certbot 验证路径
    location /.well-known/acme-challenge/ {
        root /var/www/certbot;
        try_files $uri =404;
    }

    # 其他请求代理到 Gitea
    location / {
        proxy_pass http://127.0.0.1:3000;
        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 "upgrade";
    }
}

测试配置

bash

1 2	// 省略软链接到available sudo nginx -t

应该输出

1 2	nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

重载Nginx

bash

1	sudo systemctl reload nginx

1.8 申请 Let’s Encrypt 证书（Certbot 会自动配置 HTTPS）

安装 Certbot

bash

1	sudo apt install certbot python3-certbot-nginx -y

bash

1	sudo mkdir -p /var/www/certbot

bash

1	sudo certbot --nginx -d gitea.xinghenluyus.cn

按提示操作：

输入邮箱（用于安全通知）
同意服务条款（输入 Y）
是否接收推广邮件？输入 N
是否将 HTTP 重定向到 HTTPS？选择 2（强制重定向）
浏览器打开 👉 https://gitea.xinghenluyus.cn ，如果安装过程没问题，就能正常打开gitea了

2 服务器安装 Gitea Runner

2.1 生成配置文件

bash

1 2	cd /srv/gitea-runner sudo touch config.yaml

bash

1
2
3

docker run --entrypoint="" --rm -it \
  swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitea/act_runner:0.2.11 \
  act_runner generate-config > config.yaml

2.2 在 Gitea 管理后台获取注册 token

偷个懒~

2.3 用 Docker 运行并注册

bash

docker run \
  -v /srv/gitea-runner/config.yaml:/config.yaml \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e CONFIG_FILE=/config.yaml \
  -e GITEA_INSTANCE_URL="https://gitea.xinghenluyus.cn" \
  -e GITEA_RUNNER_REGISTRATION_TOKEN="" \
  -e GITEA_RUNNER_NAME="runner-01" \
  -e GITEA_RUNNER_LABELS="linux,docker" \
  --name gitea_runner \
  -d swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/gitea/act_runner:0.2.11

再次进入管理后台，runner应该已经在线啦！

到这里你已经成功部署gitea啦！

Kubernetes 多节点快速部署

2025-09-14T16:00:00.000Z

目标环境：Ubuntu 20.04 | 3 Master + 2 Worker | keepalived + haproxy VIP(推荐，此处未写) | 容器运行时 containerd

1 节点规划（企业级 IP 分配）

主机名	物理 IP	角色	组件
k8s-m1	`10.10.50.11/24`	Master-1	kube-apiserver, etcd, controller-manager, scheduler
k8s-m2	`10.10.50.12/24`	Master-2	同上
k8s-m3	`10.10.50.13/24`	Master-3	同上
k8s-n1	`10.10.50.21/24`	Worker-1	kubelet, containerd
k8s-n2	`10.10.50.22/24`	Worker-2	同上
VIP	`10.10.50.30/24`	浮动 IP	`keepalived` 漂移地址，供 HAProxy 监听

企业网络策略确认：

DHCP 已排除 10.10.50.11-13, .21-22, .30
防火墙白名单放行所有节点间端口
重点：VIP 的 MAC 地址将使用 VRRP 虚拟 MAC，需管理员绑定该 MAC 到交换机端口

2️ 所有节点基础配置

# 2.1 更新系统 & 安装必要工具
sudo apt update && sudo apt upgrade -y
sudo apt install -y \
    apt-transport-https ca-certificates curl gnupg lsb-release chrony net-tools vim

# 2.2 关闭 swap 和防火墙
sudo swapoff -a
sudo sed -i '/ swap / s/^/#/' /etc/fstab
sudo ufw disable || true

# 2.3 时间同步（使用阿里云 NTP 服务器）
sudo sed -i '/^pool\|^server/c\server ntp.aliyun.com iburst' /etc/chrony/chrony.conf
sudo systemctl enable --now chronyd  # 使用正确服务名 chronyd.service

使用sealos快速部署

sealos run registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.29.9 \
  registry.cn-shanghai.aliyuncs.com/labring/helm:v3.9.4 \
  registry.cn-shanghai.aliyuncs.com/labring/cilium:v1.13.4 \
  --masters 172.18.51.112,172.18.51.137,172.18.51.173 \
  --nodes 172.18.51.51,172.18.51.28

kubectl taint nodes --all node-role.kubernetes.io/control-plane-

如何本地服务化部署PaddleOCR

2025-08-19T16:00:00.000Z

耗时一礼拜阅读完文档摸索出一条PaddleOCR最简单快速部署，并能通过api调用的方法。总结如下：

1 环境准备

Lunix系统
有显卡（我的是RTX4080），并且安装对应驱动
提前安装了Docker

2 通过镜像拉取环境

安装含有高性能推理依赖的 PaddleX 官方 Docker 镜像

这里推荐CUDA11.8的版本，全部依赖都是齐全的，而且不会有冲突。安装方法如下：命令参考网站

bash

# 1.拉取官方GPU镜像(以网站最新版本为准)
docker pull ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlex/paddlex:paddlex3.0.1-paddlepaddle3.0.0-gpu-cuda11.8-cudnn8.9-trt8.6

# 2.创建容器运行目录
mkdir puddlex
cd puddlex

# 3.运行容器
docker run --gpus all --name paddle-hpi -v $PWD:/paddle --shm-size=16G --network=host -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlex/paddlex:paddlex3.0.1-paddlepaddle3.0.0-gpu-cuda11.8-cudnn8.9-trt8.6 /bin/bash

# 默认直接进入容器内部了，后续退出想再次进入使用
docker attach paddle-hpi

进入容器内部安装 PaddleOCR

bash

# 1.安装PaddlePaddle
python -m pip install paddlepaddle-gpu==3.0.0 -i https://www.paddlepaddle.org.cn/packages/stable/cu118/

# 2.安装paddleocr
pip install paddleocr

验证安装

采用github上的命令，简单直接：

bash

# 运行 PP-OCRv5 推理
paddleocr ocr -i https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/general_ocr_002.png --use_doc_orientation_classify False --use_doc_unwarping False --use_textline_orientation False 

# 运行 PP-StructureV3 推理
paddleocr pp_structurev3 -i https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/pp_structure_v3_demo.png --use_doc_orientation_classify False --use_doc_unwarping False

# 运行 PP-ChatOCRv4 推理前，需要先获得千帆API Key
paddleocr pp_chatocrv4_doc -i https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/vehicle_certificate-1.png -k 驾驶室准乘人数 --qianfan_api_key your_api_key --use_doc_orientation_classify False --use_doc_unwarping False 

# 查看 "paddleocr ocr" 详细参数
paddleocr ocr --help

3 开启服务

3.1 简单服务化部署

安装服务化部署插件

bash

1	paddlex --install serving

运行服务器

bash

# OCR产线
paddlex --serve --pipeline OCR --port 8080

# PP-StructureV3
paddlex --serve --pipeline PP-StructureV3 --port 8080

3.2 启用高性能推理

安装高性能推理插件

bash

1	paddlex --install hpi-gpu

运行服务器

bash

# OCR产线
paddlex --serve --pipeline OCR --port 8080 --hpi_config

# PP-StructureV3
paddlex --serve --pipeline PP-StructureV3 --port 8080 --hpi_config

3.3 同时启动多个服务

安装screen

bash

1 2	apt-get update apt-get install -y screen

通过screen会话运行服务器

bash

# OCR产线
screen -S ocr -d paddlex --serve --pipeline OCR --port 8080 --hpi_config

# PP-StructureV3
screen -S structure -d paddlex --serve --pipeline PP-StructureV3 --port 8080 --hpi_config

管理screen会话

bash

# 查看正在运行的会话
screen -ls

# 进入某个容器(使用Ctrl+D，然后按A退出)
screen -r ocr/structure

4 API文档

详见对应文档 -> 开发集成/部署 -> API参考

ocr对应api POST /ocr
structure对应api POST /layout-parsing

欢迎评论！

如何在Volantis-5主题上使用artalk评论系统(同本站)

2025-08-17T16:00:00.000Z

artalk以私有化部署实现数据自控与极速响应，社交登录、邮件通知、Markdown 等功能开箱即用。话不多说，下面直接上教程。

这里我犯了很多错一直走回头路，一个配置反复折腾，以下是最简步骤。

1 在服务端配置 Nginx

1.1 准备工作

拥有一台服务器，并且拥有公网ip

我这里是采用了腾讯云的轻量应用云服务器，使用的Ubuntu并安装好了docker。这里采用docker部署。

1.2 解析域名到服务器

这一步主要是为了开启HTTPS，如果是动态ip，还可以配合DDNS动态解析域名。

推荐使用artalk.example.com这样的子域名格式，域名可以和博客网站保持一致，简化备案流程。

域名解析

在本地电脑打开终端，运行：

bash

1	ping artalk.example.com

如果返回的ip是解析的ip，说明解析成功。

1.3 安装 Nginx

登录你的服务器，执行：

Bash

# 更新包列表
sudo apt update

# 安装 Nginx
sudo apt install nginx -y

# 启动并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx

测试 Nginx 是否正常：

浏览器访问：artalk.example.com，看到Nginx欢迎页则说明安装成功。

1.4 创建 Nginx 配置文件(不启用 HPPTS)

创建文件

bash

1	sudo nano /etc/nginx/sites-available/artalk.xinghenluyus.cn.conf

nginx

server {
    listen 80;
    server_name artalk.xinghenluyus.cn;

    # Certbot 验证路径
    location /.well-known/acme-challenge/ {
        root /var/www/certbot;
        try_files $uri =404;
    }

    # 其他请求先不重定向（或可重定向，但不能 listen 443）
    location / {
        # 可选：先不重定向，等证书申请完再开启
        proxy_pass http://127.0.0.1:8080;
        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_set_header X-Forwarded-Port $server_port;
        proxy_set_header X-Forwarded-Host $host;

        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

测试配置

bash

1 2	// 省略软链接到available sudo nginx -t

应该输出

1 2	nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

重载Nginx

bash

1	sudo systemctl reload nginx

1.5 申请 Let’s Encrypt 证书（Certbot 会自动配置 HTTPS）

安装 Certbot

bash

1	sudo apt install certbot python3-certbot-nginx -y

bash

1	sudo mkdir -p /var/www/certbot

bash

1	sudo certbot --nginx -d artalk.xinghenluyus.cn

按提示操作：

输入邮箱（用于安全通知）
同意服务条款（输入 Y）
是否接收推广邮件？输入 N
是否将 HTTP 重定向到 HTTPS？选择 2（强制重定向）

2 服务器安装 Artalk

2.1 程序部署

执行命令在后台启动容器：

请注意ATK_SITE_DEFAULT改成你的网站title(对应_config.yml文件中title)，ATK_SITE_URL改成服务器实际解析域名。

bash

docker run -d \
    --name artalk \
    -p 8080:23366 \
    -v $(pwd)/data:/data \
    -e "TZ=Asia/Shanghai" \
    -e "ATK_LOCALE=zh-CN" \
    -e "ATK_SITE_DEFAULT=Artalk 的博客" \
    -e "ATK_SITE_URL=https://artalk.example.com" \
    artalk/artalk-go

执行命令创建管理员账户：

bash

1	docker exec -it artalk artalk admin

2.2 进入后台

主机浏览器输入 https://artalk.example.com 进入 Artalk 后台登录界面。

如果这这一步不成功，自行在 1.4, 1.5, 2.1 之间排查原因。

2.3 配置可信域名

登录后台 -> 设置 -> 可信域名

将你的博客域名 (也就是要使用这个评论系统页面的所有域名) 都添加到可信域名列表中，解决CORS报错。然后点击右下角应用。

配置示例

3 Volantis 配置 Artalk

打开_config.volantis.yml文件，添加artalk相关配置

_config.volantis.yml相关配置

如果你的Volantis版本是5.8.0，则对于新版Artalk也就是2.9.1,浏览器会弹出pjax错误。

这时有两个解决方案：

如果你是通过npm安装的，可以打开node_modules\hexo-theme-volantis\layout\_plugins\comments\artalk\script.ejs，用下面代码替换源码。(记得做好备份工作)

script.ejs

如果你是通过拉取仓库源码方式安装，可以拉取仓库最新的dev分支，我的代码已经被合并到dev分支，暂时还没作为5.8.1版本发布。

dev分支

到这里你的blog已经成功集成Artalk啦！

Windows作为Wireguard server多端异地组网解决方案

2025-08-04T16:00:00.000Z

此处为小白教程，更多细节请看我的另一篇博客 > Wireguard 在 Windows 中的亿点点细节 <

1 前言

1.1 背景

随着技术的不断革新，个人服务器算力和性能越来越强大，在家部署一台性能不错的主机，然后使用轻薄本远程办公逐渐成为一种解决方案。
奈何ip受限，稀少的ipv4地址，复杂的NAT网关，使得公网对局域网的访问难上加难。就算使用Natter加上DDNS临时动态拿到公网ip，难道你想你的电脑远程端口或者ssh端口直接暴露在公网上吗？对此SakuraFRP，向日葵，ToDesk各自给出了不同的解决方案。

这里重点推荐SakuraFrp，通过内网穿透和端口加密给出了不错的解决方案，对公网暴露设备端口并加密，而且不受NAT限制。另外两款远程软件适合临时控制或者备用检修通道，商用型强广告多，不适合长期使用

虽然SakuraFrp功能强大而且价格便宜(临时使用基本免费)，但是所有流量都要到Sakura服务器转发，带宽受限。而且随着设备的变多，错综复杂的穿透隧道让配置和部署变得极其麻烦，点对点的穿透解决方案是不可行的。

这时，完美的解决方案出现了 —> Wireguard

1.2 Wireguard介绍

WireGuard 是一种现代化的、简化的、安全的VPN（虚拟私人网络）协议。以下是对其特点及工作原理的详细介绍：

简洁性：WireGuard 的设计目标之一是简化配置和部署，其代码库远小于其他如 OpenVPN 和 IPSec 等解决方案。
性能：由于其精简的设计和对最新加密技术的应用，WireGuard 速度更快、延迟更低。
WireGuard 使用最先进的加密算法，确保数据传输的安全性。
WireGuard 可以在多种平台上运行，包括 Linux、Windows、macOS、iOS、Android 等，支持跨平台使用，同时其简单的配置流程也降低了用户的使用门槛。
通过 UDP 协议进行通信，WireGuard 能够更好地适应网络条件的变化，并且具有自动重连功能，保证连接的稳定性和可靠性。
与传统VPN不同的是，WireGuard 支持客户端使用动态IP地址，无需固定IP地址即可建立稳定的连接，且兼容ipv4和ipv6。

使用WireGuard，我们可以将所有想要直接关联的设备通过安全隧道连接起来，形成一个虚拟的专用网络，可以像局域网一样轻松访问和管理内网设备。

1.3 为什么我选择Windows作为终端server？

最主要原因，是因为我的NAS(网络附属存储)不支持docker(轻量级容器技术)，它也就变相的不支持部署Wireguard。作为家里的第二大常驻设备，我把目光瞄准到了我的PC。虽然Windows的系统使它注定无法24小时开机，但是Wake On LAN(局域网唤醒)完美的弥补了这一点。想要组网时，我远程唤醒PC开机即可。
至于为什么不把设备刷成Linux，我只能说它不止是一台server，还有别的作用(剪辑、设计、游戏)。而且使用wsl2+docker，上面完全可以部署我的服务，充当服务器的作用。

2 部署

2.1 网络环境

对于有公网ip地址的，配置路由器的端口转发即可。
对于ipv4，在NAT1的环境下，邪修使用Natter可以拿到临时公网ip。(UDP在ipv4环境跨区丢包很严重，这里不推荐没有公网ip的使用)
对于ipv6，尽量保证server环境处于NAT1，使用DDNS-GO可以将拿到的动态ipv6通过域名解析绑定到某个域名，从而实现稳定的使用。点我传送到DDNS-GO

请注意：用路由器给server分配固定ip并开启DMZ主机，确保网络环境的稳定性。

2.2 一键部署

Windows下想要完全启用Wireguard的功能，需要更改众多配置。好在已经有前人帮我们早好了轮子Wg Server for Windows，我们直接拿来用即可。

1.工具下载

从releases下载WS4W最新版本。我的版本是2.1.4。
安装完成后得到如下界面：

WS4W界面图

2.下载Wireguard

点击Download and install Wireguard，根据指引一键自动下载安装。

3.配置Server

点击Edit server configuration，进入server配置页面。

server配置页

其中Endpoint填写ip:端口(和Listen Port一致)，ip全面支持ipv4，ipv6，域名。两个Key点击Generate自动生成。其余配置照抄即可，这里不过多赘述。

3.配置clients(Server端)

点击Configure client，进入client配置页面。

client配置页

点击Add Client，会弹出类似上图的界面。
配置客户端信息，大部分可以直接Generate自动生成。要注意的是Allowed IPs配置每个客户端通过Wireguard的流量。在这里配置的所有ip段的流量都会被导向Wireguard server。比如我的配置中，除了Address流量，还有192.168.0网段的所有流量都会导向Wireguard Server转发。我这样配置不仅可以让虚拟局域网内设备相互关联，还可以从Client访问Server所在局域网。
点击Export configuration File可以生成一个文件供客户端使用。手机端还可以直接生成二维码。
点击Save保存。

4.配置clients(客户端)

客户端下载Wireguard，导入生成的那个文件直接应用配置即可。

以Windows为例，配置文件应该如下所示：

Windows配置

注意：将AllowedIPs中的10.8.0.X/32修改成整个网段，即10.8.0.0/24。

5.Server剩余配置

依次点击Install tunnel service，Make private，Enable NAT，完成剩余配置。成功后界面如下：

成功配置

不出意外的话到这里为止部署就成功了。WS4W只是一个配置工具，关闭即可，真正的配置已经落实到Windows的各个角落。

3 一些细节收尾

3.1 在 Windows 上启用路由功能

启用路由功能模拟端口转发，实现节点间通信

powershell

1	Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters" -Name "IPEnableRouter" -Value 1

在服务中找到Routing and Remote Access，设置启动类型为自动，然后启动这个服务。

3.2 配置 Windows 防火墙

允许 ICMP 回显请求（即 ping 请求）

powershell

1	New-NetFirewallRule -DisplayName "Allow ICMPv4-In" -Protocol ICMPv4 -IcmpType 8 -Enabled True -Action Allow -Profile Any

视情况开放Server的51820端口(如果Client不能连接)

到这里你的Windows已经成为Wireguard Server啦！

解决huggingface.co无法访问

2025-07-27T16:00:00.000Z

将huggingface.co换成镜像源hf-mirror.com即可解决问题。

1	解决方法：export HF_ENDPOINT=https://hf-mirror.com （可以写入到~/.bashrc中，长久可用）

windows可以创建名为HF_ENDPOINT的系统环境变量，值为https://hf-mirror.com。

参考内容如下，如果环境中有HF_ENDPOINT的设定就会采用该设定作为前缀，即上面镜像的https://hf-mirror.com而非默认的https://huggingface.co。

/path/to/env/site-packages/huggingface_hub/constants.py

SakuraFrp隧道开启https，使用个人域名并配置SSL

2025-06-26T16:00:00.000Z

官方配置文档传送门

https://doc.natfrp.com/frpc/ssl.html

我是在项目开发的过程中暂时暴露后端服务与前端通信时遇到的问题。浏览器限制要求必须使用https协议，然而Sakura自带的自签名证书会报错，甚至导致部分服务无法使用。一气之下决定彻底解决这个问题。

1 准备工作

首先，你要拥有一个自己的域名。我的域名都是腾讯云的。SSL证书的注册要求是你自己的域名。

学术研究可以考虑使用纯数字（6位，8位都可）.xyz ，十来块一年很便宜。作为常用域名还是推荐.cn后缀，国内域名，常见权威，关键是比.com便宜一大截。

然后，要有一个Sakura的账号和frpc。这里不过多赘述。

2 注册证书

这里使用 Zero SSL
1 注册账号后，跟随图片指引填写信息。注意不要选任何付费项(pro)。

3、一路next

2 选择DNS验证域名所属。记住下图信息，然后打开腾讯云控制台，创建一个CNAME解析。注意主机记录不要包括你的域名，只要前面的二级域名，也就是到XXX.sakura为止。记录值就是point to的内容照抄。
3 这个解析验证后可以删除。

4 等待解析验证通过，证书马上就下来

这个页面就成功了，可以下载证书了

5 按照上图指引，选择NGINX，然后下载，证书下载成功。

3 配置证书

3.1 配置SSL

解压下载下来的文件后，会得到3个文件，certificate.crt,ca_bundle.crt,private.key。

打开 certificate.crt 文件，复制所有内容。
打开 ca_bundle.crt 文件，复制所有内容。
创建一个新的文本文件，命名为 sakura.xinghenluyus.cn.crt。(你的域名.crt,下文以同理)
将 certificate.crt 的内容粘贴到新文件中。
在新文件末尾添加一个空行。
将 ca_bundle.crt 的内容粘贴到新文件中。
最终的 sakura.xinghenluyus.cn.crt 文件应该看起来像这样：

frp.xinghenluyus.cn.crt

-----BEGIN CERTIFICATE-----
... (your domain certificate content) ...
-----END CERTIFICATE-----

-----BEGIN CERTIFICATE-----
... (intermediate certificate chain content) ...
-----END CERTIFICATE-----

将 private.key 改名为 sakura.xinghenluyus.cn.key 。(你的域名.key)

最终得到sakura.xinghenluyus.cn.crt和sakura.xinghenluyus.cn.key。

3.2 配置SakuraFrp启动器

开启自动HTTPS，填入注册证书的域名。

开启https

启动器进入 设置 -> 打开工作目录 ,进入 FrpcWorkingDirectory 文件夹。(frpc类似，也有这个文件夹)

打开工作目录

将 sakura.xinghenluyus.cn.crt和sakura.xinghenluyus.cn.key 都粘贴到当前文件夹，如果有就覆盖系统自带的。

3.3 配置域名解析

进入腾讯云的解析，新建CNAME解析，主机记录填sakura,记录值控制台日志里抄。

新建记录

记录值来源：

记录值来自控制台日志

3.4 成功示例

开启隧道，查看控制台，证书是否加载成功。出现下图界面则成功

成功示例

这时可以浏览器连接测试，发现弹出安全警告了。

Spring Boot 集成 Redis 缓存并使用 FastJSON2 作为序列化器的完整配置指南

2025-06-11T16:00:00.000Z

在现代 Web 应用中，缓存是提升系统性能和减少数据库压力的重要手段。在最基本的SSM开发过程中，Springboot可以方便的将缓存和Redis集成，可以十分便捷的用注解开发。

个人情怀让我使用fastjson。升级到fastjson2后，原本的autotype被废除，不管是官方给出的代码示例还是论坛社区，都没有对泛型数据的支持，对于特定需求使用起来很不方便。

泛型：如果你有一个普通 Java Bean (FileEntity) ，那么List, Map 等就是泛型集合

1 引入依赖

Springboot版本采用3.2.3

pom.xml


    
        org.springframework.boot
        spring-boot-starter-data-redis
    
    
        com.alibaba.fastjson2
        fastjson2
        2.0.57
    
    
        com.alibaba.fastjson2
        fastjson2-extension-spring6
        2.0.57

2 创建自定义序列器

自定义 FastJSON2 序列化器（支持泛型）

FastJsonRedisSerializer.java

package com.example.demo.config;

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONReader;
import com.alibaba.fastjson2.TypeReference;
import org.springframework.data.redis.serializer.RedisSerializer;
import org.springframework.data.redis.serializer.SerializationException;

import java.lang.reflect.Type;

public class FastJsonRedisSerializer implements RedisSerializer {

    private static final JSONReader.Filter AUTO_TYPE_FILTER = JSONReader.autoTypeFilter(
            "com.example.demo.entity.", // 替换为你的实体包名
            "java.util.ArrayList",
            "java.util.HashMap"
    );

    private final Type type;

    public FastJsonRedisSerializer(Type type) {
        this.type = type;
    }

    public FastJsonRedisSerializer(Class clazz) {
        this.type = clazz;
    }

    @Override
    public byte[] serialize(T t) throws SerializationException {
        if (t == null) return new byte[0];
        return JSON.toJSONBytes(t, JSON.Feature.WriteClassName);
    }

    @Override
    public T deserialize(byte[] bytes) throws SerializationException {
        if (bytes == null || bytes.length == 0) return null;
        return JSON.parseObject(bytes, type, AUTO_TYPE_FILTER, JSON.Feature.SupportAutoType);
    }
}

String 类型专用序列化器

FastJson2StringRedisSerializer.java

package com.example.demo.config;

import org.springframework.data.redis.serializer.RedisSerializer;
import org.springframework.data.redis.serializer.SerializationException;

import java.nio.charset.StandardCharsets;

public class FastJson2StringRedisSerializer implements RedisSerializer {

    @Override
    public byte[] serialize(String s) throws SerializationException {
        return s == null ? new byte[0] : s.getBytes(StandardCharsets.UTF_8);
    }

    @Override
    public String deserialize(byte[] bytes) throws SerializationException {
        return bytes == null || bytes.length == 0 ? null : new String(bytes, StandardCharsets.UTF_8);
    }
}

3 配置Config

配置 RedisTemplate

RedisConfig.java

package com.example.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.StringRedisSerializer;

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate template = new RedisTemplate<>();
        template.setConnectionFactory(factory);

        FastJsonRedisSerializer valueSerializer = new FastJsonRedisSerializer<>(Object.class);
        FastJson2StringRedisSerializer stringSerializer = new FastJson2StringRedisSerializer();

        template.setKeySerializer(stringSerializer);             // key: String
        template.setHashKeySerializer(stringSerializer);         // hashKey: String
        template.setValueSerializer(valueSerializer);            // value: 泛型对象
        template.setHashValueSerializer(valueSerializer);        // hashValue: 泛型对象
        template.setDefaultSerializer(valueSerializer);
        template.setStringSerializer(stringSerializer);
        template.afterPropertiesSet();

        return template;
    }
}

配置 RedisCacheManager（用于 @Cacheable 等注解）

RedisCacheConfig.java

package com.example.demo.config;

import org.springframework.cache.annotation.EnableCaching;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.cache.RedisCacheConfiguration;
import org.springframework.data.redis.cache.RedisCacheManager;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.serializer.RedisSerializationContext;

import java.time.Duration;

@Configuration
@EnableCaching
public class RedisCacheConfig {

    @Bean
    public RedisCacheManager redisCacheManager(RedisConnectionFactory factory) {
        FastJsonRedisSerializer serializer = new FastJsonRedisSerializer<>(Object.class);

        RedisCacheConfiguration config = RedisCacheConfiguration.defaultCacheConfig()
                .serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(serializer))
                .entryTtl(Duration.ofMinutes(30)); // 设置缓存过期时间

        return RedisCacheManager.builder(factory)
                .cacheDefaults(config)
                .build();
    }
}

到此配置全部完毕

4 Spring Cache 注解详解与使用示例

4.1 @Cacheable

用途：标记方法返回值需被缓存。若缓存存在，则直接返回；否则执行方法体并缓存结果。

1 2	@Cacheable(value = "fileCache", key = "#id") FileEntity getFileById(UUID id);

4.2 @CachePut

用途：更新缓存，总是执行方法并将结果写入缓存。

1 2	@CachePut(value = "fileCache", key = "#result.id") FileEntity saveFile(FileEntity file);

4.3 @CacheEvict

用途：清除缓存中的条目。

1 2	@CacheEvict(value = "fileCache", key = "#id") void deleteFile(UUID id);

清空整个缓存区域：

1 2	@CacheEvict(value = "fileListCache", allEntries = true) void clearAllFiles();

4.4 @CacheConfig

用途：类级别共享缓存配置

@CacheConfig(cacheNames = "fileCache")
public class FileService {
    @Cacheable(key = "#id")
    public FileEntity getFileById(UUID id) {
        return fileMapper.selectById(id);
    }
}

4.5 业务层使用示例

@Service
public class FileService {

    @Autowired
    private FileRepository fileRepository;

    @Cacheable(value = "fileCache", key = "#id")
    public FileEntity getFileById(UUID id) {
        return fileRepository.selectById(id);
    }

    @CachePut(value = "fileCache", key = "#result.id")
    public FileEntity saveFile(FileEntity file) {
        fileRepository.insert(file);
        return file;
    }

    @CacheEvict(value = "fileCache", key = "#id")
    public void deleteFile(UUID id) {
        fileRepository.deleteById(id);
    }

    @Cacheable(value = "fileListCache", key = "'all'")
    public List getAllFiles() {
        return fileRepository.selectAll();
    }
}

笔记本电脑扩容并将整个D盘迁移到新硬盘

2025-03-29T16:00:00.000Z

相信小伙伴们在使用电脑时经常会出现电脑的硬盘不够用的情况。特别是C盘或者D盘的爆满，这时候单纯的加装硬盘只会让你凭空多一个盘，还是不能解决C盘或者D盘爆满的问题。

我的个人情况是C，D盘原本处于同一硬盘中，我利用磁盘迁移工具将整个D盘完美复制到了新的E盘，实现彻底的扩容。

下载工具DiskCopy

对比多个工具，DiskCopy最简单易用，功能也较为完善，还很轻量。

自行前往相应网站下载，我的版本是DiskCopy_v1.4.2.0_Chs，打开后对应界面如下：

工具界面

开始迁移数据

打开分区复制，选择对应的复制分区(原D盘)和目标分区(原E盘)，开始复制，接下来漫长等待即可。

由于我的已经修改了卷标，不要被我的F盘和D盘误导！

分区复制

修改卷标

搜索进入磁盘管理

磁盘管理

更改对应的卷标，把D先改成F，然后把E改成D。上图是修改好的样子

修改卷标

要是修改不成功应该是页面文件的问题，自行上网搜索解决。

重启电脑，验证文件特别是应用程序的完整性。没有发现问题的话F盘可以直接删除给C盘扩容啦！

中兴光猫(ZXHN 7000M)改桥接

2025-03-17T16:00:00.000Z

我采用ztuOnu工具刷光猫进入telnet。话不多说，直接开始。

1 将光猫恢复出厂设置

拔掉光纤，捅光猫的恢复出厂设置(RESET)按键，重置光猫。

光猫重置后，原先业务下发会被取消，内置的超级管理员账户会恢复初始默认的密码aDm8H%MdA，之后千万不要插入光纤，不然业务会下发，超级管理员密码会被运营商篡改。

2 下载工具ztuOnu

到ztuOnu的github发布页，下载对应版本。

我下载的版本

将压缩包解压到一个特定文件夹里，接下来我们使用这个工具强行用telnet连接光猫。

3 一些准备工作

将电脑mac地址设置为000729553557
Windows需要启用telnet客户端
拔掉光猫上所有网线，用一根网线将光猫和电脑连接起来。

4 开始刷光猫

进入工具所在的文件夹，空白地方右击 > 显示更多选项 > 在终端中打开 ,打开Powershell窗口。其它操作系统同理打开命令行即可。

使用new命令

1	.\zteOnu.exe --ip "192.168.1.1" --new --user "CMCCAdmin" --pass "aDm8H%MdA" --port 80 --tp 23 --telnet

接下来的步骤一定要迅速，要是出现登录失败的情况，请重复上一步new命令。要是出现被锁定的情况，请等待5分钟重试。

登陆telnet

1	telnet 192.168.1.1

快速输入对应的账号和密码，账号Login为root ,密码password为Zte521。如果不成功，就重新刷到成功为止。

进入光猫telnet，这时不是想干什么干什么^~^,每个光猫都默认有一个拥有最高权限超级管理员和背面显示账号密码，供用户基础操作的普通用户。这里我选择把光猫背面的普通用户提升为超级管理员，经验证，插入光纤业务下发后不会还原这个设置，相当于绕过运营商拥有了光猫的最高权限。

把光猫背面的普通用户提升为超级管理员

1	sendcmd 1 DB set DevAuthInfo 1 Level 1

保存配置

1	sendcmd 1 DB save

更多配置可以自行上网查阅资料。本教程这里可以关闭命令行了。

5 最后一些配置

插上光纤，等待业务下发。
等待光猫状态正常后，进入192.168.1.1,使用光猫背面提权过的用户，登录光猫配置页面。
删掉光猫拨号的连接，新建一条bridge的连接，记住VLAN ID保持一致，见下图红色框框。VLAN ID因人而异。

光猫管理页

还原网线，路由器设置拨号上网即可。(不知道拨号账号密码的可以致电运营商询问)

经测试，不删除TR069也可以正常改桥接。TR069是运营商下发配置的连接，一般用来动态化超级管理员密码。OTHER是机顶盒连接。

解决Windows下本地Maven仓库修改repository路径，文件夹始终为空

2025-03-14T16:00:00.000Z

我在使用IDEA构建Springboot项目时，修改了项目的默认Maven，改成了我新下载的本地Maven仓库。

在使用.xml文件进行配置时，IDEA报错：

1	未解析的依赖项: 'org.mybatis:mybatis-spring:jar:2.0.6'

我在网上搜索了各种教程和相关资料，都没有得到解决。最后当我打开Maven的自定义本地仓库文件夹，居然发现里面是空的！

检查了环境变量，又检查了配置文件，均未发现异常。经排查，原因如下:

我将Maven根目录放在了D:\Program Files\apache-maven-3.9.9,而Program Files文件夹的权限是管理员权限(猜测是之前安装什么环境时用安装程序安装，导致文件夹权限变高)。

默认没有管理员权限只可读

为了不破坏原有程序文件，我将Maven根目录移动到D:\Program Files (x86)\apache-maven-3.9.9,重新配置环境变量和配置文件，重启IDEA，问题解决。

PS：猜测只报错一个依赖的原因不是出在依赖本身，而是拉取第一个依赖就无法写入，后续依赖的拉取自动被停止，只报错了第一个依赖，导致误判出错原因。大家要养成良好的安装习惯！

从零搭建个人博客（基于Hexo，使用Volantis主题，部署在github并上传cdn）

2025-03-09T16:00:00.000Z

这是我的第一篇博客，也是本站的部署记录。

1 前言

相信每一个想部署个人博客的小伙伴们都想快速上手个人博客。在众多框架中，hexo以庞大的使用群体胜出，成为了我的选择。而Volantis主题又以清新脱俗的小众化吸引了我的注意。

在网站的部署上，我选择部署在GitHub pages（毕竟谁不喜欢有稳定又白能嫖的渠道呢）。碍于国内访问速度过慢，我将网站上传CDN提升国内访问速度，并使用了自己的域名blog.xinghenluyus.cn.

本站仅提供个人部署思路.

2 Hexo安装

2.1 环境配置

安装Node.js
安装Git

具体教材可以自行上网搜索

2.2 安装Hexo

点击这里前往Hexo官方文档。

全局安装npm

npm install -g hexo-cli

//国内镜像源也可以使用
cnpm install -g hexo-cli

初始化博客文件夹

1 2	//cd到要存放博客的本地文件夹 hexo init myblog

安装相关依赖

1 2	cd myblog npm install

启动服务

1 2	hexo g hexo server

按照提示打开浏览器

访问http://localhost:4000/,出现下图界面则部署成功。

本地浏览器界面

之后，就可以在source/_posts中创建md文件写自己的代码啦，也可以用new命令，个人感觉没必要，直接创建，省时省力。

每次更改Hexo代码后，都要重新启动服务

2.3 部署到GitHub Pages

如果你跟我一样把网站托管到GitHub，最好是有一个~~科学上网~~工具。

创建GitHub仓库

登录GitHub，new 一个 Repository，Repository name一定要是你的用户名.github.io。如下图所示，报错是因为仓库已经存在。

新建仓库页面

第一次使用时出现下图报错，推荐直接删除仓库重新创建！

安装git插件

1	npm install hexo-deployer-git --save

修改blog/_config.yml配置文件

找到下文代码段，覆盖修改。其中yourname替换成自己的github用户名。

blog/_config.yml

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repository: https://github.com/yourname/yourname.github.io.git
  branch: main

全部完成后，执行如下命令：

1 2	hexo c && hexo g && hexo d # hexo d 表示执行部署, hexo c 会清除hexo g 生成的文件，一般连用

命令行最后一行输出如下信息则表示上传成功：

1	INFO Total precache size is about 1.98 MB for 26 resources.

执行成功可以通过yourname.github.io来访问博客了。

2.4 安装Volantis主题（可选）

传送门 Volantis官方文档

这里我采用npm安装

在blog/_config.yml文件中找到并修改：

blog/_config.yml

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: volantis

npm下载主题

1 2	//cd到个人博客本地根目录 npm i hexo-theme-volantis

2.5 配置Volantis主题（可选）

博客根目录下新建 _config.volantis.yml文件,这是主题自带的配置文件，可以覆盖blog\node_modules\hexo-theme-volantis下_config.yml的配置，起到主题全局配置的作用。

这里推荐一个我参考的博客，具体配置这里不再赘述：

给自己的hexo博客个性化Volantis主题

https://blog.csdn.net/qq_42887663/article/details/128209285

我的_config.volantis.yml文件 (点击展开)

Luyus的个人站点

Wireguard 在 Windows 中的亿点点细节

1 Windows 杂谈

2 命令行操作

3 IP转发

4 跨接口转发

在腾讯轻量应用服务器部署gitea和runner

1 安装gitea

1.1 准备工作

1.2 创建目录与权限

1.3 编写docker-compose.yml

1.4 部署命令

1.5 解析域名到服务器

1.6 安装 Nginx

1.7 创建 Nginx 配置文件(不启用 HPPTS)

1.8 申请 Let’s Encrypt 证书（Certbot 会自动配置 HTTPS）

2 服务器安装 Gitea Runner

2.1 生成配置文件

2.2 在 Gitea 管理后台获取注册 token

2.3 用 Docker 运行并注册

Kubernetes 多节点快速部署

1 节点规划（企业级 IP 分配）

2️ 所有节点基础配置

如何本地服务化部署PaddleOCR

1 环境准备

2 通过镜像拉取环境

3 开启服务

3.1 简单服务化部署

3.2 启用高性能推理

3.3 同时启动多个服务

4 API文档

如何在Volantis-5主题上使用artalk评论系统(同本站)

1 在服务端配置 Nginx

1.1 准备工作

1.2 解析域名到服务器

1.3 安装 Nginx

1.4 创建 Nginx 配置文件(不启用 HPPTS)

1.5 申请 Let’s Encrypt 证书（Certbot 会自动配置 HTTPS）

2 服务器安装 Artalk

2.1 程序部署

2.2 进入后台

2.3 配置可信域名

3 Volantis 配置 Artalk

Windows作为Wireguard server多端异地组网解决方案

1 前言

1.1 背景

1.2 Wireguard介绍

1.3 为什么我选择Windows作为终端server？

2 部署

2.1 网络环境

2.2 一键部署

3 一些细节收尾

3.1 在 Windows 上启用路由功能

3.2 配置 Windows 防火墙

解决huggingface.co无法访问

SakuraFrp隧道开启https，使用个人域名并配置SSL

1 准备工作

2 注册证书

3 配置证书

3.1 配置SSL

3.2 配置SakuraFrp启动器

3.3 配置域名解析

3.4 成功示例

Spring Boot 集成 Redis 缓存并使用 FastJSON2 作为序列化器的完整配置指南

1 引入依赖

2 创建自定义序列器

3 配置Config

4 Spring Cache 注解详解与使用示例

4.1 @Cacheable

4.2 @CachePut

4.3 @CacheEvict

4.4 @CacheConfig

4.5 业务层使用示例

笔记本电脑扩容并将整个D盘迁移到新硬盘

下载工具DiskCopy

开始迁移数据

修改卷标

中兴光猫(ZXHN 7000M)改桥接

1 将光猫恢复出厂设置

2 下载工具ztuOnu

1.3 编写`docker-compose.yml`