这次重新搭建个人主页，我原本只是想换一个更顺手的前端方案，最后却意外把 GitHub Actions 用成了网站背后的“内容编辑器”。

tech GitHub Actions GitHub 自动化 Base UI 个人主页 Mon, 13 Apr 2026 00:00:00 GMT

这次重新搭建个人主页，我原本只是想换一个更顺手的前端方案，最后却意外把 GitHub Actions 用成了网站背后的“内容编辑器”。

重新搭建主页时，我在想什么

前段时间，我把自己的个人主页重新搭了一遍。

一开始的目标其实很简单：页面干净一点，结构清楚一点，部署轻一点。于是我用 React、Vite 和 Base UI 重新把整个站点梳理了一遍，再挂到 Vercel 上，让它保持一个静态站点该有的轻盈。

但真正开始做之后，我很快发现，主页最难的地方从来不是“搭出来”，而是“养起来”。

页面本身可以很快上线，可一旦内容要靠手动维护，它就很容易停在某个时刻不再生长。写了新文章，要手动补最近文章；开了新仓库，要手动补项目展示。时间一长，主页就会变成一个样子还在、气息却慢慢淡下去的页面。

所以这次重搭主页时，我想解决的其实不是样式，而是更新方式：能不能让它看起来是静态的，但内容是缓慢流动的。

Base UI 给我的一个小启发

这次重搭还有一个让我印象很深的地方，是 Base UI 对 LLM 的友好度。

它除了常规文档之外，还专门提供了 llms.txt，官方也明确提到，可以把文档的 Markdown 版本或者 llms.txt 直接提供给 AI 助手，帮助模型更准确地理解组件和 API。

这个细节让我很有感触。因为它其实在做一件很现代的事：不是只考虑“人怎么读文档”，而是连“模型怎么理解文档”也一起考虑进去了。

某种程度上，我后来给主页做的内容链路，思路也是一样的：先把信息整理成稳定、结构化、容易消费的形式，再交给后面的系统去展示。

后来我把主页拆成了两部分

做到后面，我慢慢把整个主页理解成了两层：

1. 前台页面：负责展示
2. 后台内容流：负责更新

前台页面就是 React + Vite + Base UI。

后台内容流则是我后来补上的自动化链路：

• 从博客里抓最近文章
• 从 GitHub 抓最近公开仓库
• 生成本地的 data/content.ts
• 提交回仓库
• 让 Vercel 自动重新部署

这样一来，前端运行时不需要再去现场请求博客或者 GitHub API，而是直接读取已经生成好的本地数据。

我很喜欢这种方式。因为它保留了静态站点的简单，又让内容更新这件事变得不那么依赖人的勤快。

GitHub Actions 在这里，像一个安静的内容编辑器

这个项目里，我最喜欢的部分其实是 .github/workflows/refresh-content.yml。

它做的事情并不复杂：

1. 检出仓库
2. 安装 Node.js 22
3. 执行 npm ci
4. 运行 npm run generate:content
5. 只暂存 data/content.ts
6. 如果有变化，就自动提交并推送

它支持手动触发，也支持定时触发：

1
2
3
4

on:
  workflow_dispatch:
  schedule:
    - cron: '0 0 * * *'

对我来说，这个工作流最妙的地方在于，它并不像传统 CI 那样强调“测试通过、构建完成、发布成功”，而更像一个很安静的编辑器，在背后定时帮我整理内容。

而 Vercel 又刚好接上了这一步：仓库一旦有新的提交，站点就自动重新部署。

于是整条链路就很顺了：

• GitHub Actions 负责更新内容
• GitHub 仓库负责保存结果
• Vercel 负责把最新页面上线

页面表面上很安静，但背后一直有一条自动化的水流在走。

这次重搭主页，反而让我重新认识了 GitHub Actions

以前我对 GitHub Actions 的理解比较朴素：跑测试、做构建、自动部署。

当然这些都没错，但这次做完之后，我更强烈地感觉到，GitHub Actions 真正有趣的地方，不只是它能替你“发布代码”，而是它能替你“处理那些重复、稳定、适合被机器接手的事情”。

把它放到个人项目里，这种感受会更明显。

因为个人项目最容易卡住的地方，往往不是技术难度，而是维护意志。很多事情不是不会做，而是懒得重复做。GitHub Actions 恰好就适合接这种活。

除了刷新主页内容，GitHub Actions 其实还能做很多事

这次做完主页之后，我反而开始觉得，GitHub Actions 在个人项目里的用法其实可以比 CI/CD 更宽一些。

1. 定时同步内容

这是我这次实际用到的一类。

只要某些数据来源是公开且稳定的，Actions 就很适合定时去抓取、清洗、生成本地数据，再交给静态站点渲染。

比如：

• 个人主页同步最近文章
• 作品集同步最近项目
• 导航页同步书签、工具或订阅内容
• 静态页面定时生成榜单、清单、摘要

这种用法的好处是，页面本身还是静态的，但内容不会完全停住。

2. 自动生成仓库里的展示内容

很多仓库里的 README、项目首页、徽章信息，其实都可以自动维护。

例如：

• 自动刷新 README 中的项目状态
• 自动生成最近更新记录
• 自动汇总 issue / release 信息
• 自动整理博客、视频、文章索引

这类事情人工也能做，但很容易拖。交给 Actions 之后，仓库会更像一个持续生长的对象，而不是写完就不再更新的代码堆。

3. 做一些轻量的数据备份和归档

个人项目里还有一类事情特别适合 Actions：周期性备份。

比如：

• 定时导出某些公开数据
• 定时备份配置文件或生成产物
• 定时把分散的信息汇总成一个仓库内可追踪的快照

它不一定要很重，也不一定非得是企业级备份系统。有时候只是把零散的数据定期沉淀下来，就已经很有价值了。

4. 让静态网站拥有一点“动态感”

我现在越来越喜欢的一种思路是：

不要急着把网站做成一个实时请求一堆接口的动态系统，而是先看看能不能用 Actions 把动态信息提前烘焙成静态内容。

这样做通常更简单，也更稳。

对个人网站尤其如此：

• 页面访问更快
• 外部依赖更少
• 部署更直接
• 出问题时更容易定位

很多看上去需要“动态”的需求，最后其实只要“每天更新一次”就够了。

写到这里，我反而觉得这像是一种网站观

这次重新搭主页，最后带给我的并不只是一个新的页面，而是一种更舒服的工作方式。

前端负责把页面铺开，GitHub Actions 负责把内容整理好，Vercel 负责把结果送到线上。每一层都不重，但组合起来之后，网站就有了持续更新的能力。

我越来越喜欢这种感觉：

• 页面是静的
• 内容是流动的
• 人只负责决定方向
• 机器负责处理重复劳动

如果以后我再用一句话概括这次重搭主页的收获，大概会是：

GitHub Actions 最有意思的地方，不只是帮我部署网站，而是帮我照看网站背后那条持续流动的内容线。

参考

• ox0pine/ox0pine.top
• Base UI llms.txt
• GitHub Actions 工作流语法文档

最低成本上线在线服务，避免购买公网IP服务器。

ox0pine tech 网络工具 Cloudflare Sat, 24 Jan 2026 00:00:00 GMT

最低成本上线在线服务，避免购买公网IP服务器。

什么是 Cloudflare Tunnel

Cloudflare Tunnel（原名 Argo Tunnel）是 Cloudflare 提供的一项免费服务，可以让你在不需要公网 IP 的情况下，将本地服务安全地暴露到互联网上。它通过在你的服务器和 Cloudflare 网络之间建立加密隧道来工作。

主要优势

• 无需公网 IP：不需要购买昂贵的公网 IP 或 VPS
• 免费使用：Cloudflare 免费计划即可使用
• 自动 HTTPS：自动配置 SSL 证书
• DDoS 防护：享受 Cloudflare 的安全防护
• 隐藏源站：真实服务器 IP 不会暴露

前置准备

1. 一个 Cloudflare 账号（注册地址）
2. 一个已添加到 Cloudflare 的域名
3. 一台可以运行服务的机器（本地电脑、内网服务器等）

安装 cloudflared

Windows

下载并安装 cloudflared：

1
2
3
4
5

# 下载最新版本
# 访问 https://github.com/cloudflare/cloudflared/releases
# 下载 cloudflared-windows-amd64.exe

# 重命名为 cloudflared.exe 并添加到系统 PATH

macOS

使用 Homebrew 安装：

1

brew install cloudflare/cloudflare/cloudflared

Linux

1
2
3
4
5
6
7

# Debian/Ubuntu
wget -q https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
sudo dpkg -i cloudflared-linux-amd64.deb

# CentOS/RHEL
wget -q https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-x86_64.rpm
sudo rpm -i cloudflared-linux-x86_64.rpm

验证安装：

1

cloudflared --version

快速开始：临时隧道

如果只是想快速测试，可以使用临时隧道（不需要域名）：

1
2

# 将本地 8080 端口暴露到公网
cloudflared tunnel --url http://localhost:8080

运行后会生成一个临时的 *.trycloudflare.com 域名，可以直接访问。

创建永久隧道

Cloudflare Tunnel 提供两种创建方式：命令行方式（CLI） 和 Dashboard 方式（Web 界面）。你可以根据自己的喜好选择。

方式一：命令行创建（推荐）

适合喜欢命令行操作的开发者，配置更灵活。

1. 登录 Cloudflare

1

cloudflared tunnel login

这会打开浏览器，选择你要使用的域名并授权。授权成功后会在本地生成证书文件。

2. 创建隧道

1

cloudflared tunnel create my-tunnel

这会创建一个名为 my-tunnel 的隧道，并生成一个 UUID 和凭证文件。记下这个 UUID，后面会用到。

3. 配置隧道

创建配置文件 ~/.cloudflared/config.yml（Windows 在 %USERPROFILE%\.cloudflared\config.yml）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

tunnel: <你的隧道UUID>
credentials-file: /path/to/.cloudflared/<UUID>.json

ingress:
  # 将 blog.example.com 路由到本地 4000 端口（Hexo 默认端口）
  - hostname: blog.example.com
    service: http://localhost:4000

  # 将 api.example.com 路由到本地 3000 端口
  - hostname: api.example.com
    service: http://localhost:3000

  # 捕获所有其他请求（必需）
  - service: http_status:404

4. 配置 DNS

将域名指向隧道：

1
2

cloudflared tunnel route dns my-tunnel blog.example.com
cloudflared tunnel route dns my-tunnel api.example.com

这会自动在 Cloudflare DNS 中创建 CNAME 记录。

5. 运行隧道

1

cloudflared tunnel run my-tunnel

现在访问 https://blog.example.com 就能访问到你的本地服务了！

方式二：Dashboard 创建（图形界面）

适合不熟悉命令行的用户，操作更直观。

1. 进入 Cloudflare Zero Trust

1. 登录 Cloudflare Dashboard
2. 选择你的账号
3. 进入 Zero Trust → Networks → Tunnels
4. 点击 Create a tunnel

2. 选择连接器类型

选择 Cloudflared 作为连接器类型，点击 Next。

3. 命名并安装

1. 为隧道命名（如 my-blog-tunnel）
2. 点击 Save tunnel
3. 根据你的操作系统选择对应的安装命令
4. 在服务器上运行显示的命令（包含 token）

示例命令：

1
2
3
4
5

# Linux/macOS
sudo cloudflared service install <your-token>

# Windows（以管理员身份运行）
cloudflared.exe service install <your-token>

5. 安装完成后，连接器会显示为 Connected
6. 点击 Next

4. 配置路由

有两种配置方式：

A. 发布公开应用（Public Hostname）

1. 在 Public Hostname 标签下
2. 填写配置：
   • Subdomain: 输入子域名（如 blog）
   • Domain: 选择你的域名（如 example.com）
   • Type: 选择 HTTP
   • URL: 输入本地服务地址（如 localhost:4000）
3. 点击 Save tunnel

B. 连接私有网络（Private Network）

1. 切换到 Private Network 标签
2. 输入私有 IP 或 CIDR 范围（如 192.168.1.0/24）
3. 点击 Save tunnel

5. 验证状态

配置完成后，返回 Tunnels 页面，你的隧道应该显示为 Healthy 状态。现在就可以通过配置的域名访问你的服务了！

两种方式对比

建议：

• 如果你是开发者或需要管理多个隧道，推荐使用命令行方式
• 如果你只需要快速部署一个服务，Dashboard 方式更简单

现在访问 https://blog.example.com 就能访问到你的本地服务了！

配置为系统服务

Linux (systemd)

1
2
3
4
5
6
7
8
9

# 安装服务
sudo cloudflared service install

# 启动服务
sudo systemctl start cloudflared
sudo systemctl enable cloudflared

# 查看状态
sudo systemctl status cloudflared

Windows

1
2

# 以管理员身份运行
cloudflared service install

macOS

1
2
3
4
5

# 安装服务
sudo cloudflared service install

# 启动服务
sudo launchctl start com.cloudflare.cloudflared

高级配置

多个服务配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

tunnel: <UUID>
credentials-file: /path/to/credentials.json

ingress:
  # Web 服务
  - hostname: www.example.com
    service: http://localhost:80

  # SSH 服务
  - hostname: ssh.example.com
    service: ssh://localhost:22

  # WebSocket 服务
  - hostname: ws.example.com
    service: http://localhost:8080
    originRequest:
      noTLSVerify: true

  # 默认规则
  - service: http_status:404

访问控制

在 Cloudflare Dashboard 中可以配置 Access 策略，限制谁可以访问你的服务：

1. 进入 Cloudflare Dashboard
2. 选择你的域名
3. 进入 Access → Applications
4. 创建新的应用程序并配置访问规则

日志配置

1
2
3
4
5
6
7
8
9
10

tunnel: <UUID>
credentials-file: /path/to/credentials.json

# 日志级别：debug, info, warn, error
loglevel: info

ingress:
  - hostname: example.com
    service: http://localhost:8080
  - service: http_status:404

常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 列出所有隧道
cloudflared tunnel list

# 查看隧道信息
cloudflared tunnel info my-tunnel

# 删除隧道
cloudflared tunnel delete my-tunnel

# 清理未使用的连接
cloudflared tunnel cleanup my-tunnel

# 测试配置文件
cloudflared tunnel ingress validate

# 测试特定 URL 的路由
cloudflared tunnel ingress rule https://blog.example.com

故障排查

1. 隧道无法连接

检查服务状态：

1
2
3
4
5

# Linux
sudo systemctl status cloudflared

# 查看日志
sudo journalctl -u cloudflared -f

2. 502 Bad Gateway

• 确认本地服务正在运行
• 检查配置文件中的端口是否正确
• 确认防火墙没有阻止本地连接

3. DNS 解析问题

1
2
3
4
5

# 检查 DNS 记录
nslookup blog.example.com

# 重新配置 DNS
cloudflared tunnel route dns my-tunnel blog.example.com

4. 证书问题

1
2
3
4
5

# 重新登录
cloudflared tunnel login

# 检查证书文件是否存在
ls ~/.cloudflared/

实际应用场景

1. 个人博客部署

将本地运行的 Hexo 博客暴露到公网：

1
2
3
4

ingress:
  - hostname: blog.example.com
    service: http://localhost:4000
  - service: http_status:404

2. 开发环境分享

快速分享本地开发环境给团队成员：

1

cloudflared tunnel --url http://localhost:3000

3. 家庭服务器

将家里的 NAS、媒体服务器等暴露到公网：

1
2
3
4
5
6

ingress:
  - hostname: nas.example.com
    service: http://192.168.1.100:5000
  - hostname: media.example.com
    service: http://192.168.1.101:8096
  - service: http_status:404

4. IoT 设备管理

安全地访问内网的 IoT 设备管理界面。

安全建议

1. 启用 Cloudflare Access：为敏感服务添加身份验证
2. 使用强密码：为本地服务设置强密码
3. 定期更新：保持 cloudflared 版本最新
4. 最小权限原则：只暴露必要的服务
5. 监控日志：定期检查访问日志

性能优化

1. 选择合适的数据中心：cloudflared 会自动选择最近的 Cloudflare 数据中心
2. 启用压缩：Cloudflare 会自动压缩内容
3. 使用缓存：配置适当的缓存规则
4. HTTP/2 支持：Cloudflare Tunnel 原生支持 HTTP/2

总结

Cloudflare Tunnel 是一个强大且免费的工具，特别适合：

• 个人开发者快速部署项目
• 没有公网 IP 的家庭服务器
• 需要临时分享本地服务
• 需要安全访问内网资源

通过本教程，你应该已经掌握了 Cloudflare Tunnel 的基本使用方法。现在就可以开始使用它来部署你的服务了！

参考资料

• Cloudflare Tunnel 官方文档
• cloudflared GitHub 仓库
• Cloudflare Dashboard

ox0pine life 生活 周记 Wed, 26 Nov 2025 00:00:00 GMT 项目更新

WebMonitor

自从上周完成了一个初版以后，这周使用 AI 又继续更新，添加了一些小功能。

一些 feature：

• 添加黑名单域名，处于黑名单内的域名不能被普通用户添加为监控任务。
• 用户在创建任务时可以将任务进行公开，公开以后别的用户可以订阅，为后续添加添加付费功能做预备。

TODO

• 加入对 Python 脚本的支持，当脚本打印的内容变动时，也进行通知。

v2ray 安装脚本

一些 fix

• 添加自定义端口设置，避免一台服务器有多个用户使用发生端口冲突的问题。
• 更友好地的proxy_on和proxy_off，可以直接把代理配置从～/.bashrc中添加或删除。

又写了什么脚本

大模型的训练数据总是停留在某年某月某日的，有时候我们需要使用的某些库已经更新了，使用方法和函数的接口已经发生了很大的变化，这时候要想让 AI 写出比较正确的代码，成为了一个比较棘手的问题。

我想出的解决方法是让 AI 把这个项目或者库的文档爬取出来整理成 md 格式供我们使用的 AI 后续查阅，能很好的降低幻觉，或者说是避免数据的过时性。比如下面这个截图是我用脚本整理出来的 gymnasium 的使用文档。

怎么安排学习

由于上周末刚去了北京出差（虽然什么事情也没做成，客观原因），也意味着横向可以暂时告一段落了，这周慢慢把主线拉回到科研、技术提升上面来。这周找导师讨论了下面要做的方向，给定了一个比较难的方向，不知道能不能做出来，但是还是先试试再说吧。

• 论文阅读、实验持续进行
• Java 项目学习推进

萧瑟秋风今又是，换了人间。

这几年折腾过不少建站工具。大一刚开始用的是 Hexo]]> ox0pine life 生活 周记 Mon, 17 Nov 2025 00:00:00 GMT 建站之路：绕了一圈回到原点

这几年折腾过不少建站工具。大一刚开始用的是 Hexo，但总感觉美观度不够、主题选择有限、自定义能力也受限。后来尝试过 Hugo、WordPress 等工具，可 Hugo 还需要配置服务器，WordPress 又老是提示插件不安全。

最后还是回到了 Hexo。至少可以直接部署到 GitHub Pages，不用担心安全问题，再大的流量和攻击都不怕宕机，也不用长时间购买国外 VPS（国内的 VPS 绑定域名还得备案）。重新用 HexO 搭建网站，有种熟悉的感觉。

本周动态

学习充电

最近准备开始 Java 项目开发，把 Java 基础知识重新巩固了一遍。跟着 yupi 的教程 学习，教程内容很扎实，配合 Dia 浏览器的侧边栏 AI 助手，遇到不懂的地方随时提问，学习效率提升了不少。

生活点滴

研究生数学建模比赛出成绩了，拿到了三等奖。说实话，比赛刚开始几天就后悔参加了，但学校规定只有成功参赛才能报销报名费，为了报名费也只能硬着头皮把代码写完，论文部分就交给队友负责了。正如陈粒歌里唱的「无所求便满载而归」，虽然三等奖不算理想的成绩，但考虑到自己投入的时间和精力有限，结果还算满意。

创意清单

• 学习 Go 语言开发终端工具，比如一个增强版的 SSH 工具，具体功能还在构思中
• 重构网页变化监控项目，改为前后端分离架构，放在简历上展示「已完成，项目链接」

工具分享

这周试了一下 Google 新发布的 IDE，但使用时总是出现 Error，目前还不够成熟。个人觉得这种 IDE 形式的 AI 工具有待改进，期待 Gemini CLI 能尽快用上 3 Pro 模型。

自古逢秋悲寂寥，我言秋日胜春朝。此图片拍摄于 2024 年 11 月初北京东城区地坛公园，秋意初显，天高气爽。

从小在农村长大，父母都是地地道道的农民，他们对于教育的理解很简单：读书能改变命运。这句话在我成长的二十多年里，像一道无形的光，指引着我一路向前。

从小学到高中，我]]> ox0pine life 生活 研究生 Sun, 16 Nov 2025 00:00:00 GMT 作为一名典型的小镇做题家，可能也说不上小镇，应该还比这低一级，应该叫做农村做题家。

从小在农村长大，父母都是地地道道的农民，他们对于教育的理解很简单：读书能改变命运。这句话在我成长的二十多年里，像一道无形的光，指引着我一路向前。

从小学到高中，我一直是老师眼中的好学生，父母口中的骄傲。在那个教育资源相对匮乏的环境里，我只能通过一次次的考试来证明自己。高考那年，我成了村里第一个考上重点大学的本科生。还记得当时父亲激动得几天没睡好觉，逢人就说自己儿子有出息了。

大学四年，我继续延续着高中时期的学习模式。专业课成绩名列前茅，各种奖学金拿到手软，看似一路风光。但内心深处，我始终有一种不安全感——害怕落后，害怕辜负家人的期望，害怕在这个陌生的城市里没有立足之地。

大三那年，面临读研还是就业的抉择，我几乎没有犹豫就选择了考研。因为在我的认知里，更高的学历意味着更好的工作，更高的收入，更光明的前途。这或许是所有”做题家”共同的思维定式：继续做题，直到再也无题可做。

然而，真正进入研究生阶段后，我发现这个世界和我想象中的完全不一样。

研究生不再是刷题背书就能获得好成绩的阶段。科研需要的是创造力、批判性思维，以及面对挫折时的韧性。这些恰恰是我过去十几年教育中最缺乏的部分。我习惯了有标准答案的题目，习惯了按部就班完成任务，但在科研中，往往没有标准答案，甚至连问题都需要自己去发现。

刚开始的一年，我经历了前所未有的挫败感。实验屡次失败，论文被导师反复修改，同门同学一个个取得进展而我却原地踏步。我开始怀疑自己是否适合读研，怀疑自己过去十几年建立起来的”学霸”身份是不是一场骗局。

那段时间，我经常失眠，整夜整夜地思考一个简单的问题：读研后悔吗？

从理性的角度来说，我应该是不后悔的。研究生学历让我在就业市场上有更多选择，让我有机会接触更深层次的专业知识，让我结识了一群优秀的朋友和师长。但情感上，我却时常感到后悔。

我后悔的不是读研本身，而是在读研过程中失去了很多东西。我失去了那种简单纯粹的快乐，失去了对未来美好生活的憧憬，失去了面对困难时的从容淡定。我开始变得功利，开始计算每一件事情的性价比，开始用结果来评判一切。

更让我痛苦的是，我发现自己和家人的期望越来越远。在他们眼中，研究生应该是一份光鲜亮丽的身份，应该能找到待遇优渥的工作，应该能够光宗耀祖。但现实是，研究生毕业后，我依然要和本科生一样在就业市场上竞争，甚至因为年龄更大、期望更高而更加艰难。

去年寒假回家，母亲问我读研到底有什么用，能不能比本科生多挣多少钱。我一时语塞，不知道该如何回答这个问题。是告诉她研究生培养的是科研能力和思维方式，这些软实力很难用金钱衡量？还是承认在经济回报上，研究生的优势并没有想象中那么明显？

现在的我，已经渐渐接受了这种矛盾。我不再纠结于是否后悔读研，而是开始思考如何让这段经历变得有意义。或许，成长本身就是这样一个不断质疑、不断否定的过程。

回望这段读研岁月，虽然充满了迷茫和挣扎，但也让我获得了许多宝贵的财富。我学会了独立思考，学会了面对不确定性，学会了接受自己的不完美。更重要的是，我开始理解父母那一代人的局限性，也开始理解他们对我期望背后的良苦用心。

现在再有人问我读研后悔吗，我会告诉他们：说不后悔是假的，但如果再给我一次选择的机会，我还是会选择读研。不是因为学历的光环，也不是因为更好的就业前景，而是因为这段经历让我真正认识了世界，也认识了更真实的自己。

也许，这就是教育最根本的意义——不是让我们变得多么优秀，而是让我们能够勇敢地面对自己的平凡，并在平凡中找到属于自己的幸福。

作为一名曾经的农村做题家，我现在终于明白，人生不是一道道标准答案的题目，而是一篇需要自己书写的文章。这篇文章或许不会惊艳世人，但只要真诚地写完每一页，就足够了。

将科研工作的第一关由配置各种镜像源改编为配置网络环境。

tech V2Ray 代理 服务器 网络工具 自动化脚本 Tue, 11 Nov 2025 00:00:00 GMT

将科研工作的第一关由配置各种镜像源改编为配置网络环境。

V2Ray 代理安装模块

V2Ray 完整版安装脚本，无需 root 权限即可安装，支持 VMess、VLESS、Shadowsocks 协议，具备完整的服务器管理和订阅切换功能。

功能特性

• ✅ 多协议支持: VMess、VLESS、Shadowsocks
• ✅ 智能订阅解析: 自动解析多种格式订阅链接
• ✅ 服务器管理: 节点切换、状态监控、自动重连
• ✅ 代理模式: 本机代理 / 局域网共享
• ✅ 安全认证: 支持用户名密码认证
• ✅ DNS 优化: 国内 DNS 优化配置
• ✅ 智能路由: 分流规则，国内外流量智能处理

快速使用

步骤 1：准备工作

如果服务器网络受限无法直接访问外网，需要先建立临时代理隧道：

1
2

# 在本地机器上执行（确保本地有代理服务运行在10809端口，根据自己情况，设置别的端口也可以）
ssh -R 10809:127.0.0.1:10809 username@your-server-ip -p ssh-port

然后在服务器上设置临时代理：

1
2

export http_proxy=http://127.0.0.1:10809
export https_proxy=http://127.0.0.1:10809

步骤 2：下载并运行安装脚本

1
2
3
4
5
6
7
8

# 下载安装脚本
wget https://raw.githubusercontent.com/ox0pine/server-scripts/main/proxy/linux/install_v2ray.sh

# 给脚本执行权限
chmod +x install_v2ray.sh

# 运行安装脚本
./install_v2ray.sh

步骤 3：输入订阅链接

安装过程中会提示输入 V2Ray 订阅链接：

1

请输入订阅链接: https://your-subscription-url.com/link/xxxxx

步骤 4：选择服务器

脚本会自动解析订阅并显示所有可用服务器，选择一个进行连接：

1
2
3
4
5
6
7
8
9

=== 所有服务器 (25) ===
[1] 🔵 香港-VMess-01
    VMESS - hk1.example.com:443
[2] 🟢 美国-VLESS-02
    VLESS - us1.example.com:443
[3] 🟡 日本-SS-03
    SHADOWSOCKS - jp1.example.com:8080

请选择要使用的服务器 (1-25) [默认: 1]: 1

步骤 5：完成安装

安装完成后，运行以下命令加载别名配置：

1
2
3

source ~/.bashrc
proxy_on
source ~/.bashrc

基本管理命令

安装完成后，可使用以下别名命令（需要 source ~/.bashrc 生效）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 服务管理
v2start          # 启动V2Ray
v2stop           # 停止V2Ray
v2restart        # 重启V2Ray
v2status         # 查看状态
v2log            # 查看日志

# 服务器管理
v2switch         # 切换服务器
v2list           # 列出所有服务器
v2vmess          # 列出VMess服务器
v2vless          # 列出VLESS服务器
v2ss             # 列出Shadowsocks服务器

# 订阅管理
v2update         # 更新订阅
v2scan           # 重新解析订阅

# 代理连接
v2connect        # 快速连接代理
proxy_on         # 开启代理
proxy_off        # 关闭代理
proxy_status     # 查看代理状态

配置说明

代理端口配置

DNS 配置

• 国内 DNS: 223.5.5.5 (阿里云)
• 备用 DNS: 114.114.114.114
• 国外 DNS: 8.8.8.8 (Google)
• 分流规则: 国内外流量智能分流

路由规则

• 直连: 私有 IP、国内 IP、国内域名
• 代理: 国外 IP 和域名
• 策略: IPOnDemand 智能选择

文件结构

安装完成后，V2Ray 的工作目录位于 ~/v2ray/：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

~/v2ray/
├── v2ray                    # V2Ray 主程序
├── config.json              # 当前配置文件
├── servers_all.json         # 所有服务器配置
├── subscription.txt         # 原始订阅内容
├── subscription_url.txt     # 订阅链接
├── v2ray.log                # 运行日志
├── v2ray.pid                # 进程PID文件
├── full_parser.py           # 订阅解析脚本
├── server_manager.py        # 服务器管理脚本
├── start.sh                 # 启动脚本
├── stop.sh                  # 停止脚本
├── restart.sh               # 重启脚本
├── status.sh                # 状态脚本
├── switch.sh                # 切换脚本
├── update.sh                # 更新脚本
└── connect.sh               # 连接脚本

常见问题

Q: 如何更换订阅链接？

A: 运行 v2update 命令，选择输入新的订阅链接即可。

Q: 如何切换到其他服务器？

A: 运行 v2switch 命令，选择要切换的服务器编号。

Q: 局域网其他设备如何连接？

A: 确保选择局域网共享模式，使用以下地址：

• SOCKS5: socks5://用户名:密码@服务器IP:1080
• HTTP: http://用户名:密码@服务器IP:8080

Q: 如何查看当前使用的服务器？

A: 运行 v2status 命令，会显示当前服务器信息。

Q: 连接失败怎么办？

A:

1. 检查 v2status 确认服务运行状态
2. 查看 v2log 检查错误日志
3. 尝试 v2switch 切换其他服务器
4. 运行 v2update 更新订阅

更新日志

v3.0

• 新增 VLESS 协议支持
• 优化订阅解析算法
• 改进服务器管理界面
• 增强错误处理机制
• 添加连接测试功能

v2.0

• 重构配置生成逻辑
• 支持局域网共享模式
• 添加用户认证功能
• 优化 DNS 配置

v1.0

• 基础 VMess 支持
• 简单订阅解析
• 基本服务器切换

技术支持

如遇到问题，请：

1. 查看本文档的常见问题部分
2. 检查日志文件 ~/v2ray/v2ray.log
3. 提交 Issue 到项目仓库

相关资源

• 完整脚本仓库: https://github.com/ox0pine/server-scripts
• V2Ray 官方文档: https://www.v2fly.org/

注意: 本脚本仅用于学习和研究目的，请遵守当地法律法规。