占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

占位文：提纲与正文待补。

要点（待写）

参考

三视图

Q 版

美型

生成说明

角色立绘、造型、三视图及 Logo 等素材均由 AI 图像生成，再经去底、裁切等后期处理，用于本人站点、作品与项目中的标识与展示。形象为原创拟人设定，不关联任何商业动画 / 游戏官方角色。

| 写法 | 含义 |
|

| 写法 | 含义 | 示例 |
|

| 写法 | 含义 |
|

| 写法 | 含义 |
|

ACOJ 是在线评测（OJ）monorepo：在 HEI 脚手架上扩展题库、提交判题与多执行机调度，提供 Admin（Vue 3）、Portal（React 19）与统一 Spring Boot API。判题执行依赖 SparkSandbox：沙箱只编译与限资源运行，AC / WA 在 ACOJ 裁决。Apache License 2.0。

相对「沙箱内直接出最终结果」的一体化 OJ，隔离执行与题目语义拆开：执行机加权调度、熔断、排水、租约换机；平台保留测例版本、标签、发布校验与做题统计。modules/oj 叠在脚手架之上，而不是从零拼一套账号与存储。

特性

• 双端账号：ADMIN / PORTAL 独立会话（Sa-Token）；密码 RSA、验证码、失败锁定与限流；JustAuth（可配置）
• RBAC：账号 / 角色 / 部门 / 用户组 / 岗位；菜单、按钮与 API 授权；会话踢出
• 系统管理：字典、动态配置（敏感项加密）、Banner、公告、反馈、弱口令库
• 对象存储：S3 兼容（MinIO / RustFS / OSS），直链或预签名
• 运维：审计与告警、登录日志、运营工作台、sys_job / Lock4j
• 题库：CRUD、测例 INLINE / OBJECT、标签、参考答案、试跑与发布校验
• 提交与判题：多语言入队；RabbitMQ；加权调度、熔断 / 排水 / 租约换机；业务侧裁决
• 判题节点：oj_judge_node 登记沙箱；心跳探活；oj_judge_dispatch 派发审计
• 个人中心：公开资料、安全设置、实名认证；做题统计

API 前缀 /api/v1/admin/* 与 /api/v1/portal/*。子工程：admin · portal · server。

技术栈

• 后端：JDK 21 · Spring Boot 4.1 · Maven · 虚拟线程
• 持久化：MySQL / PostgreSQL · MyBatis-Plus · Dynamic Datasource
• 缓存 / 会话 / 队列：Redis · Redisson · Sa-Token · RabbitMQ
• 管理端：Vue 3 · Vite · TypeScript · Naive UI · UnoCSS
• 门户：React 19 · Vite · TypeScript · Ant Design
• 判题：SparkSandbox（HMAC）
• 其他：JustAuth · AWS SDK v2（S3）· Hutool · MapStruct · Knife4j / SpringDoc

相关项目

• SparkSandbox：隔离编译与运行
• hei-boot · hei-admin · hei-portal：server / 双端同源脚手架

code-guide（摸鱼猫泡泡）：VuePress + Theme Hope，笔记按系列归档，项目以独立文章介绍。

内容以 Markdown 为主，站点工程与文档内容同仓，便于一起迭代主题、组件与检索。

特性

• 笔记：语言、工具、运维、软考与实践等系列
• 项目：一篇对应一个项目，含定位、特性与示意
• 构建：pnpm docs:dev / pnpm docs:build

go-blog 是个人博客全栈系统：后端 Go（Gin + GORM），前端含博客前台、管理端与简历站。单管理员模型，支持 Docker 部署。

因为懒得维护动态博客——既不如静态站点用 Markdown 编写方便，也不便备份——所以把之前自己做的博客系统整理出来并开源了。

特性

• 前台：文章、项目、搜索与简历页
• 管理端：概览、文章、站点配置与个人中心
• 技术栈：Go 1.22+ · Gin · GORM · Vue 3 · Naive UI

M3U8 Downloader 是面向 HLS 的跨平台桌面下载器：解析 master / media playlist，并发拉取 TS 分片，ffmpeg -c copy remux 为 MP4。引擎在 Rust，界面 React，壳层 Tauri 2，覆盖 Windows、macOS、Linux。当前版本 0.1.1，MIT。

相对「脚本拼接分片」，清晰度选择、AES-128、代理与自定义请求、任务/分片控制、断点续传和边下边播放进同一任务模型。安装包见 Releases。

特性

• 清单与变体：master playlist，下载前选择清晰度
• 加密分片：明文 HLS 与 #EXT-X-KEY AES-128-CBC
• 传输控制：Headers、Cookie、Referer、HTTP(S) 代理、并发度、输出路径
• 任务队列：暂停 / 继续 / 取消 / 删除；按已落盘分片续传
• 分片粒度：详情内单独开始、停止、重试；任务级操作中断在途请求
• 边下边播：本地 HLS 播放已连续分片；完成后打开 MP4
• 封装输出：ffmpeg remux；可选清理临时分片

技术栈

• 桌面壳：Tauri 2
• 下载引擎：Rust · Tokio · reqwest
• 界面：React 19 · TypeScript · Vite · Ant Design
• 封装：ffmpeg（打包 binaries）

ResumeFloat 是跨平台置顶悬浮简历速拷工具：默认 Compact 为「标签 + 一键复制」，可切入编辑。条目由可组合块构成（纯文本 / Markdown / 富文本 / 图片），数据落 SQLite，支持整库导出导入。当前版本 0.1.1，MIT。

面试、网申、即时通讯反复粘贴自我介绍、项目要点、联系方式时，置顶窗口减少在文档与聊天之间切换。v* 标签触发 Actions 构建三端安装包，见 Releases。

特性

• 置顶悬浮：无边框 always-on-top，标题栏拖拽；钉住与下拉菜单
• Compact 速拷：标签 + 预览（超长省略）；按块顺序拼装剪贴板
• 主题：深色 / 浅色，本地记住
• 块编辑：增删条目；块类型动态添加、排序、删除
• 内容类型：纯文本 · Markdown（编辑 / 预览）· 富文本（TipTap）· 图片
• 持久化：items / blocks；图片在配置目录 assets/
• 导出 / 导入：resume.db + assets/；导入前确认覆盖

技术栈

• 桌面壳：Tauri 2
• 界面：React 19 · TypeScript · Vite · Ant Design
• 内容：TipTap · react-markdown · marked
• 存储：@tauri-apps/plugin-sql · clipboard-manager · dialog · fs

SparkSandbox 是 Linux 上的隔离执行 HTTP 服务，不是对外 SDK。任意语言发 HTTP 完成编译与运行，HMAC 验签由调用方实现。响应含 stdout、stderr、资源用量与执行状态；支持多测例、checker、interactive pipeline、文件仓与 SSE。仓内 Python 仅供本仓测试。当前版本 0.1.1，MIT。

OJ、在线 IDE、作业评测把「跑用户代码」交给本服务；AC / WA 留在业务侧。ACOJ 判题执行即对接此服务。

特性

• 双层实现：引擎负责隔离与状态分类；编排负责语言表、worker 池、CompileCache、FileStore、多测例并行
• 执行状态：succeeded、compile_failed、runtime_error、time_limit_exceeded、memory_limit_exceeded、output_limit_exceeded、security_violation、internal_error；stage 区分 compile / run
• 语言表：默认 C11、C++17、Python 3、Java 17、Go、Node.js；镜像另开 Rust 与 SQLite；YAML 可声明 SQL 客户端语言
• 评测形态：多测例、checker、interactive、文件仓、SSE
• 容器：toolchain base 与 server 分层；--privileged --cgroupns=host

技术栈

• 引擎：C++20 · namespaces · cgroup · seccomp
• 编排：Python 3.10+ · FastAPI
• 交付：Docker 双层镜像

Startpage 是静态托管的个人书签导航起始页：无后端、无数据库，书签写在源码。url 必填，title / description 可手写覆盖；未手写则 Microlink 拉元数据，失败回退 hostname。在线：jiangbyte.github.io/startpage。

浏览器默认页 + 分类书签 + 多搜索引擎，不引入账号或同步服务。main 推送后 Actions 构建 dist/ 部署 Pages。

特性

• 数据即代码：分类与条目在 src/data/bookmarks.ts；字符串简写等价于只填 url
• 元数据：双写 title / description 则不请求外部接口；缓存 2 小时硬过期，超过 1 小时后台刷新
• 图标：解析站点自身 favicon；失败用字母头像
• 搜索：searchEngines 切换后回车，新标签打开，查询词 %s 占位
• 发布：GitHub Actions → GitHub Pages

技术栈

• 构建：Vite
• 界面：React · TypeScript
• 托管：GitHub Pages

相对「一份单体里切 admin/portal」，端隔离：Admin 只挂管理 API，Portal 只挂门户 API，前端互不引用对方源码。相对单语言脚手架，同一七层在三种运行时对齐。

特性

• 端分离：Admin / Portal 各仓各端口
• DDD 七层：types · api · domain · infrastructure · case/cases · trigger · app
• 依赖方向：Trigger → API → Case → Domain ← Infrastructure
• Java：Maven 多模块 {project}-types … -app
• FastAPI：仓库根扁平包，无 src/ 包装层
• Gin：internal/{types,api,domain,infrastructure,cases,trigger} + cmd/app
• Web / 移动：Vue 3、React 19、uni-app 双端
• 模板仓：骨架默认注释中间件；充实模板含账户竖切，S3 / Milvus / Spring AI / MCP 注释接入（原 voxel-ddd-ai-lite 已合并）

技术栈

• 后端：JDK 21 · Python 3.11+ · Go 1.25+
• 前端：Vue 3 · React 19 · uni-app
• 协议：OpenAPI / Apifox（docs/api/openapi）

系列仓库

后端

• voxel-boot-admin · voxel-boot-portal
• voxel-fastapi-admin · voxel-fastapi-portal
• voxel-gin-admin · voxel-gin-portal

前端

• voxel-admin · voxel-portal
• voxel-admin-uniapp · voxel-portal-uniapp

模板

• voxel-ddd-lite-strcut · voxel-ddd-lite

玄鉴（Xuanjian） 是面向运维与现场排查的 AI 桌面工作台：主机清单、本地 / SSH / WSL 终端、SFTP、脚本与笔记、会话录制、本机网络工具与 Docker 侧栏，并内置 玄鉴 Agent。LangGraph 本地编排，在独立下栏终端可观测执行，按 ReAct 完成排查与运维。数据落 SQLite，跨 Windows / macOS / Linux。当前版本 1.3.7，MIT，io.github.jiangbyte.xuanjian。

相对「终端 + 散落脚本」，机群、会话、文件、自动化与 Agent 收进同一应用；相对纯云端 Copilot，命令走本机 PTY / SSH，轨迹可回放。

特性

• 主机操作台：分组、标签、排序；口令 AES；一键 SSH 或粘贴 user@host
• 终端工作区：本地 Shell 与 SSH（xterm）；多标签 keep-alive；左侧文件 / 脚本 / 历史 / 概览 / 进程 / 端口 / Docker；右侧 Agent 与笔记
• 玄鉴 Agent：Orchestrator + SubAgent（巡检 / 终端 / 部署 / 分析）；计划 / 确认 / 完全权限；MCP 动态合并；上下文压缩与用量计量
• 下栏终端：与主终端分离的独立 PTY；terminal_run / session_exec 输出可见
• 模型：自定义供应商；OpenAI 兼容与 Anthropic Messages；思考强度与上下文窗口可配
• SFTP：双栏浏览、上传下载、冲突处理、内联编辑
• Docker：容器、镜像、网络与卷；实时日志；Agent docker_* 工具
• 脚本与笔记：脚本包、变量占位、多目标执行；Markdown 分类自动保存
• 会话日志：I/O 录制、筛选、回放、导出
• 网络工具：Ping / 路由 / DNS、IP 计算、端口、HTTP / TLS、测速、连接与流量
• 自动化：批量脚本、Cron、告警、机群概览、审计控制台
• 数据安全：SQLite；工作空间同步与 deploy 配方；备份导出（可选 AES）

技术栈

• 桌面壳：Tauri 2 · SQLite / Dialog / Clipboard
• 界面：React 19 · TypeScript · Vite · Tailwind CSS · shadcn/ui · Zustand
• 终端与编辑：xterm.js · Monaco · Markdown · XYFlow · Recharts / ECharts
• Agent：LangGraph（agent-core）· Tauri 适配层（agent-adapters）· MCP
• 会话与网络：Rust · Tokio · russh / russh-sftp · portable-pty · aes-gcm

CentOS 7 自带的包管理是 Yum 不是 Dnf，而且官方源里没有 MySQL，得自己加仓库。这篇文章就是我在 CentOS 7 上装 MySQL 的完整记录，包括几种不同的安装方式，方便下次忘了回来看。

先看看系统版本

cat /etc/redhat-release
hostnamectl

输出是 CentOS Linux release 7.x 就没问题。如果是 8 或 9 那包管理就变成 Dnf 了，步骤不太一样。

安装前要确认的事

• 你有 sudo 权限
• 机器能联网（离线场景下面有单独的方法）
• 防火墙要不要开 3306 端口看你自己需求

方法一：用 Yum 装（最省事）

先把仓库加上

Oracle 官方准备好了 RPM 包，一行命令搞定：

sudo yum install -y https://dev.mysql.com/get/mysql80-community-release-el7-11.noarch.rpm

装完之后系统里会多一个 /etc/yum.repos.d/mysql-community.repo，里面有好几个子仓库，默认启用的是 MySQL 8.0。

想换版本的话

| 仓库名 | 版本 | 说明 |
|

Ubuntu 的 APT 源里自带 MySQL，装起来比 CentOS 省心不少。不过默认版本可能不是最新的，想指定版本或者用官方最新版也有办法。

方法一：APT 直接装（最省事）

sudo apt update
sudo apt install mysql-server

装完启动：

sudo systemctl start mysql
sudo systemctl enable mysql

然后跑一下安全配置脚本：

sudo mysql_secure_installation

这个脚本会一步步引导你改 root 密码、删匿名用户、禁止 root 远程登录、删测试数据库。别跳过。

方法二：装特定版本

APT 里其实各个版本都有独立的包名：

sudo apt install mysql-server-8.0   # 装 8.0
sudo apt install mysql-server-5.7   # 装 5.7（如果源里还有的话）

方法三：用官方 APT 仓库（想用最新版）

如果 APT 里的版本太老，可以用 Oracle 官方的仓库：

wget https://dev.mysql.com/get/mysql-apt-config_0.8.24-1_all.deb
sudo dpkg -i mysql-apt-config_0.8.24-1_all.deb
sudo apt update
sudo apt install mysql-server

安装过程中会让你选版本，选好之后装的就是官方最新版了。

基本操作

检查状态

sudo systemctl status mysql

连 MySQL

sudo mysql -u root -p

创建用户和数据库

CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';
CREATE DATABASE dbname;
GRANT ALL PRIVILEGES ON dbname.* TO 'username'@'localhost';
FLUSH PRIVILEGES;

配置文件位置

| 文件 | 路径 |
|

两台机器，主库 CentOS 7，从库 Ubuntu，配 MySQL 主从复制。这篇是实际操作记录，方便下次复用。

主库配置（CentOS）

改配置文件

sudo vi /etc/my.cnf

在 [mysqld] 段加这些：

[mysqld]
server-id = 1                         # 主库 id，随便填，唯一就行
log_bin = /var/log/mysql/mysql-bin.log
read-only = 0                         # 0 表示读写（主库）
binlog_expire_logs_seconds = 2592000  # 日志保留 30 天
max_binlog_size = 100M
# binlog_do_db = astro_code            # 只同步指定库
# binlog_ignore_db = mysql,sys         # 不同步的库

创建日志目录

sudo mkdir -p /var/log/mysql
sudo chown mysql:mysql /var/log/mysql
sudo chmod 755 /var/log/mysql

重启主库

sudo systemctl restart mysqld

创建复制专用用户

主库上创建个用户给从库用：

mysql -u root -p

CREATE USER 'copyuser'@'120.26.180.149' IDENTIFIED WITH mysql_native_password BY 'MySql@123456';
GRANT replication slave ON *.* TO 'copyuser'@'120.26.180.149';

查看主库状态

SHOW MASTER STATUS;

记下返回的 File 和 Position，从库配置的时候要用。

从库配置（Ubuntu）

改配置文件

sudo vi /etc/mysql/mysql.conf.d/mysqld.cnf

[mysqld]
server-id = 2
log_bin = /var/log/mysql/mysql-bin.log
read-only = 1                         # 从库只读
binlog_expire_logs_seconds = 2592000
max_binlog_size = 100M
replicate_do_db = astro_code          # 只同步这个库
replicate_ignore_db = mysql,sys       # 不同步系统库

创建日志目录

sudo mkdir -p /var/log/mysql
sudo chown mysql:mysql /var/log/mysql
sudo chmod 755 /var/log/mysql

重启从库

sudo systemctl restart mysql

配置同步

mysql -u root -p

STOP SLAVE;
RESET SLAVE ALL;

CHANGE MASTER TO 
MASTER_HOST='47.99.236.69',          -- 主库 IP
MASTER_USER='copyuser',              -- 刚才创建的复制用户
MASTER_PASSWORD='MySql@123456',
MASTER_LOG_FILE='mysql-bin.000004',  -- 主库 SHOW MASTER STATUS 的 File
MASTER_LOG_POS=161383;               -- 主库 SHOW MASTER STATUS 的 Position

START SLAVE;

检查同步状态

SHOW SLAVE STATUS \G;

重点关注两个字段：

• Slave_IO_Running: Yes
• Slave_SQL_Running: Yes

两个都是 Yes 就说明同步正常。

踩过的坑

日志位置对不上

主库换了配置或者重启过，binlog 文件和位置会变。重新跑一次 SHOW MASTER STATUS，拿到新的 File 和 Position，在从库重新 CHANGE MASTER TO。

主从数据不一致

从库如果之前写过数据，跟主库对不上会导致同步中断。先 STOP SLAVE，从库追上数据之后再 START SLAVE。

防火墙

主库 3306 端口要放行从库 IP：

# CentOS
sudo firewall-cmd --permanent --add-source=从库IP --add-port=3306/tcp
sudo firewall-cmd --reload

总结

1. 主库：开 binlog、建复制用户、记下 File 和 Position
2. 从库：配 server-id、指向主库的 CHANGE MASTER TO、START SLAVE
3. 验证：SHOW SLAVE STATUS 两个线程都是 Yes 就没问题

CentOS 7 默认源里没有 Redis，得自己想办法。这篇整理了几种装法，从最省事的 Yum 到手动编译，看情况选就行。

方法一：Yum 装（最省事）

先加 EPEL 仓库

Redis 在 EPEL（Extra Packages for Enterprise Linux）里：

sudo yum install epel-release

然后直接装

sudo yum install redis

启动服务

sudo systemctl start redis
sudo systemctl enable redis
sudo systemctl status redis

方法二：编译安装（想要最新版本）

Yum 里的 Redis 版本一般比较老，想尝鲜就自己编译。

装编译工具

sudo yum groupinstall "Development Tools"
sudo yum install tcl

下载源码编译

cd /tmp
wget http://download.redis.io/redis-stable.tar.gz
tar xzf redis-stable.tar.gz
cd redis-stable
make
sudo make install

准备配置目录和数据目录

sudo mkdir /etc/redis
sudo mkdir /var/lib/redis
sudo cp redis.conf /etc/redis/

方法三：Remi 仓库装（折中方案）

Remi 仓库里有比较新的 Redis 版本，又不用自己编译：

sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum --enablerepo=remi install redis

基本配置

改配置

sudo vi /etc/redis.conf

几个常用的配置项：

# 绑定 IP，0.0.0.0 表示允许所有 IP 访问
bind 0.0.0.0

# 保护模式（外网访问要关掉）
protected-mode no

# 密码（建议设一个）
requirepass your_password

# 持久化策略
save 900 1
save 300 10
save 60 10000

改完重启：

sudo systemctl restart redis

测试一下

redis-cli
127.0.0.1:6379> ping
PONG
127.0.0.1:6379> set test "Hello Redis"
OK
127.0.0.1:6379> get test
"Hello Redis"

防火墙放行（如果需要远程连）

sudo firewall-cmd --permanent --add-port=6379/tcp
sudo firewall-cmd --reload

安全配置

Redis 默认没有密码，裸奔很危险。几个基本操作：

设密码

requirepass your_strong_password

禁掉危险命令

rename-command FLUSHDB ""
rename-command FLUSHALL ""
rename-command CONFIG ""

限制绑定 IP

如果只在本机用，绑 127.0.0.1 就好：

bind 127.0.0.1

验证安装

# 看看版本
redis-server --version

# 跑个性能测试
redis-benchmark -q -n 100000

总结

• 图省事 → Yum + EPEL，一行搞定
• 要最新 → 编译安装，就是多等几分钟
• 想折中 → Remi 仓库，版本新又不用编译

生产环境记得设密码、绑 IP、禁危险命令，别裸奔。

Ubuntu 比 CentOS 省心点，APT 源里直接有 Redis，不用额外加仓库。不过版本可能不是最新的，想尝鲜还是得自己编译。

方法一：APT 装（最省事）

更新源然后直接装

sudo apt update
sudo apt install redis-server

启动服务

sudo systemctl start redis-server
sudo systemctl enable redis-server
sudo systemctl status redis-server

方法二：编译安装（想要最新版本）

APT 里的版本一般落后一两个大版本，想用最新的就自己编译。

装编译工具

sudo apt update
sudo apt install build-essential tcl

下载源码编译

cd /tmp
wget https://download.redis.io/redis-stable.tar.gz
tar -xzvf redis-stable.tar.gz
cd redis-stable
make
sudo make install

准备配置目录

sudo mkdir /etc/redis
sudo mkdir /var/redis
sudo cp redis.conf /etc/redis/

基本配置

测试连接

redis-cli
127.0.0.1:6379> ping
PONG
127.0.0.1:6379> set test "hello"
OK
127.0.0.1:6379> get test
"hello"
127.0.0.1:6379> exit

改配置

sudo nano /etc/redis/redis.conf

几个常用的：

bind 127.0.0.1       # 绑定 IP
port 6379            # 端口
requirepass yourpassword  # 密码
daemonize yes        # 后台运行

改完重启：

sudo systemctl restart redis-server

安全配置

设密码

requirepass your_strong_password

禁危险命令

rename-command FLUSHDB ""
rename-command FLUSHALL ""
rename-command CONFIG ""

防火墙

sudo ufw allow from your_ip to any port 6379

验证安装

redis-server --version
redis-benchmark -q -n 100000

总结

• 图省事 → APT 直接装，一行搞定
• 要最新 → 编译安装，多等几分钟

Ubuntu 比 CentOS 舒服的地方就是 APT 源自带 Redis，不用折腾仓库。生产环境一样要设密码、绑 IP、禁危险命令。

安装包下载地址：
https://pan.quark.cn/s/6a455cd4bce2

下载内容包括：Keil5 安装包（MDK540.exe）及注册机（keygen.exe）

安装 Keil5

正常安装

参考文献

https://segmentfault.com/a/1190000047918396

实现上需要解决三个问题：签名怎么算、参数放哪里、消息怎么写。

签名算法

飞书官方文档给出的签名示例：

import hashlib
import base64
import hmac

def gen_sign(timestamp, secret):
    string_to_sign = '{}\n{}'.format(timestamp, secret)
    hmac_code = hmac.new(
        string_to_sign.encode("utf-8"),
        digestmod=hashlib.sha256
    ).digest()
    sign = base64.b64encode(hmac_code).decode('utf-8')
    return sign

注意这里的 hmac.new 调用是 hmac.new(key, msg=None, digestmod=sha256)，key 是 timestamp\nsecret，msg 为空。和通常的 hmac.new(secret, data, digestmod) 写法不一样，如果习惯性地把 secret 放第一个参数、string_to_sign 放第二个，签名就对不上。

时间戳单位

飞书用的是秒（int(time.time())）。如果写成了 time.time() * 1000，服务端验签就会失败。

# 飞书：用秒
timestamp = str(int(time.time()))

timestamp = str(int(time.time() * 1000))

参数位置

另一个容易踩坑的地方是 timestamp 和 sign 参数放在哪里。最初的习惯是把它们作为 URL 查询参数拼在 Webhook 地址后面：

https://open.feishu.cn/open-apis/bot/v2/hook/xxx?timestamp=xxx&sign=xxx

飞书实际要求的是放在 JSON body 里：

{
    "timestamp": "1742821707",
    "sign": "xxxxxx",
    "msg_type": "text",
    "content": {"text": "消息内容"}
}

拼在 URL 上也不会报错，但签名校验通不过。

消息格式

飞书自定义机器人支持多种消息类型。最常用的是文本格式：

{
    "msg_type": "text",
    "content": {
        "text": "消息正文"
    }
}

富文本（post）格式支持更复杂的排版：

{
    "msg_type": "post",
    "content": {
        "post": {
            "zh_cn": {
                "title": "标题",
                "content": [
                    [{
                        "tag": "text",
                        "text": "说明文字"
                    }, {
                        "tag": "a",
                        "text": "链接文字",
                        "href": "http://example.com"
                    }]
                ]
            }
        }
    }
}

测试验证

Webhook 配置页面上加了一个测试按钮，填好 Webhook URL 和可选签名密钥后可以直接发一条测试消息到群聊。后端对应一个测试端点，复用同样的签名和发送逻辑。

不填密钥时直接发送，收不到说明 URL 或网络有问题。填了密钥收不到，说明签名计算和服务端预期的不一致，排查上面三个点。

技术选型大致是：

| 能力 | 选型 |
|

邮件发送引擎

项目在 app/platform/email/sender.py 中实现了 send_mail 函数，支持普通 SMTP 和 STARTTLS 两种模式：

async def send_mail(to_email: str, subject: str, body: str) -> None:
    mail = settings.mail
    if not mail.host or not mail.from_email:
        raise BusinessError("Mail service is not configured")
    message = EmailMessage()
    message["From"] = f"{mail.from_name} <{mail.from_email}>"
    message["To"] = to_email
    message["Subject"] = subject
    message.set_content(body)
    await asyncio.to_thread(_send_sync, message)

邮件配置通过 MailSettings 集中管理，包括 SMTP 地址、端口、账号密码、TLS 开关等。配置项可在管理后台运行时修改，启动时从 sys_config 表加载覆盖。

用 Mailpit 本地测试邮件

Mailpit 是一个用 Go 写的轻量级邮件测试工具。它启动一个假的 SMTP 服务器，接收所有发来的邮件存在内存里，通过 Web 界面查看，不会真的发出去。

docker run -d --name mailpit \
  --restart no \
  -p 1025:1025 \
  -p 8025:8025 \
  swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/axllent/mailpit:v1.30.0

Mailpit Web 界面访问 http://localhost:8025。配置邮件时将 SMTP 地址填 localhost:1025，关掉 TLS 即可。

密码重置流程

用户请求重置时，填写邮箱提交到后端 forgot_password 接口。后端验证账号存在且状态正常，生成一次性令牌存入 Redis（设置 TTL），然后通过 SMTP 发送包含重置链接的邮件。

async def forgot_password(self, payload, account_type, client_ip=None, user_agent=None):
    email = payload.email.strip().lower()
    account = await self.account_repo.get_account_by_identifier(email, [EMAIL])

    reset_token = generate_token()
    redis = self._required_redis()
    await redis.setex(
        password_reset_token_key(reset_token),
        settings.auth.password_reset_token_ttl_seconds,
        json.dumps({"account_id": account.id, "email": email, "token_hash": hash_password(reset_token)}),
    )
    reset_link = self._build_password_reset_link(account_type, email, reset_token)
    await send_mail(email, subject, body)

邮件中的链接只带 token 参数：

http://localhost:5173/auth/forgot-password?token=4GRjtfMusvS4w6qjMZ3...

前端页面检测到 URL 中有 token 参数后切换到重置密码模式。用户输入新密码提交到 reset_password 接口：

async def reset_password(self, payload, account_type, client_ip=None, user_agent=None):
    raw = await redis.get(password_reset_token_key(payload.token))
    data = json.loads(raw)
    if not verify_password(payload.token, data["token_hash"]):
        raise AuthenticationError("Invalid or expired reset link")

    async with transactional(self.db):
        await self.account_repo.update_password_hash(account.id, hash_password(payload.password))
    await redis.delete(key)
    await self.session_service.delete_account_sessions(account.account_type, account.id)

验证 token 哈希、更新密码、删除 Redis 中的记录（一次性使用），同时清除该账号的所有活跃会话，使其他设备上的登录态失效。

邮箱暴露在重置链接中

最初的 _build_password_reset_link 方法把邮箱拼在了 URL 参数里：

def _build_password_reset_link(self, account_type, email, token):
    base_url = settings.mail.password_reset_url
    separator = "&" if "?" in base_url else "?"
    return f"{base_url}{separator}email={urlencode({'email': email})}&token={token}"

邮件中的链接长这样：

http://...?email=admin%40example.com&token=4GRjtfMusv...

邮箱地址暴露在 URL 中，可能被浏览器历史、Referer 头、中间代理等渠道泄漏。

改成 token-only，Redis 的 key 从 password:reset:{account_type}:{email} 改为 password:reset:{token}，凭 token 即可从 Redis 中反查出 email 和 account_id：

def _build_password_reset_link(self, account_type, email, token):
    base_url = settings.mail.password_reset_url
    separator = "&" if "?" in base_url else "?"
    return f"{base_url}{separator}{urlencode({'token': token})}"

ResetPasswordRequest 去掉 email 字段，后端从 token 存储的数据中反查：

class ResetPasswordRequest(CaptchaMixin, PasswordKeyMixin):
    token: str = Field(min_length=16, max_length=256)
    password: str = Field(min_length=1, max_length=512)

前端页面也不再从 URL 读取 email，改为用户手动输入，确保重置链接即使被拦截也无法直接关联到具体账号。

诺依曼系统计算机

• 计算机硬件
• 计算机软件

系统架构定义

定义：IEEE 1471-2000 标准

架构是体现在组件中的一个系统的基本组织、它们彼此的关系与环境的关系及指导它的设计和发展的原则。

架构设计的作用：

1. 解决相对复杂的需求分析问题
2. 解决非功能属性在系统中占据重要位置的设计问题
3. 解决生命周期长、扩展性需求高的系统整体结构问题
4. 解决系统基于组件需要的集成问题
5. 解决业务流程再造难的问题

软件架构发展历程

模块化开发六大原则

1. 最高模块内聚。也就是在一个模块内部的元素最大限度地关联，只实现一种功能的模块是高内聚的，具有三种以上功能的模块则是低内聚的。
2. 最低耦合。也就是不同模块之间的关系尽可能弱，以利于软件的升级和扩展。
3. 模块大小适度。颗粒过大会造成模块内部维护困难，而颗粒过小又会导致模块间的耦合增加。
4. 模块调用链的深度（嵌套层次）不可过多。
5. 接口简单、精炼（扇入扇出数不宜太大），具有信息隐蔽能力。
6. 尽可能地复用已有模块

软件架构常用分类

分层架构

• 四层结构：表现层、业务层、持久层、数据库层
• 最常见的软件架构，事实标准架构；用户的请求将依次通过这四层的处理，不能跳过其中任何一层

事件驱动架构

• 四个部分：事件队列（入口）、分发器（分发）、事件通道（联系渠道）、事件处理器（实现业务逻辑）
• 异步处理、解耦的系统

微核架构（插件架构）

• 内核相对较小，主要功能和业务逻辑都通过插件实现

微服务架构

• 服务导向架构（SOA）的升级，每一个服务就是一个独立的部署单元，单元都是分布式
  的，互相解耦
• 三种实现模式：RESTful API 模式、RESTful 应用模式、集中消息模式

云架构

• 数据都复制到内存中，变成可复制的内存数据单元，处理单元按需启停，没有中央数据库
• 两部分成：处理单元 + 虚拟中间件（消息中间件 (Messaging Grid)、数据中间件 (Data Grid)、处理中间件 (Processing Grid)、部署中间件 (Deployment Manager)）

常用建模方法与"4+1"视角模型

4 种建模方法（怎么描述架构）

| 建模方法 | 一句话解释 | 关注什么 |
|

2025 年 6 月至 2026 年 6 月，我参与了校园在线评测平台的研发。该项目的目标是建立一个面向教学与竞赛的在线训练系统，该平台旨在完成题目发布、程序提交与自动评测，为学生和教师提供练习、批改与运营管理等服务。我在该项目中担任系统架构师，全程参与了系统的分析规划和设计工作。本文以该项目为例，详细探讨软件架构风格在软件系统架构中的应用及其实现。

在构建该评测平台时，我们采用了分层组合的架构模式，执行层能够解释并运行用户程序，确保多种语言在统一规则下安全评测；而消息层则对评测任务进行异步分发，提供了低耦合的构件协作能力。这两层结构相互补充，使得平台既能满足高峰提交，又能进行在线维护与扩展。通过解释器对评测协议进行适配，结合消息中间件进行任务调度，我们成功打造了一个稳定可用的在线评测系统。通过这一实践，我们进一步验证了软件架构风格在现代软件系统架构中的重要性和实用性。

在我的带领下，项目实施的非常顺利，于 2026 年 6 月成功上线运行，并获得业主单位的一致好评。

正文

随着程序设计教学规模扩大和集中训练日益频繁，原有手工收作业、本机批改的方式已难以支撑并发提交和安全隔离。公司自 2025 年 3 月起开展需求调研，规划建设一套可扩展的在线评测平台。

2025 年 6 月我司受托建设本项目。本项目面向校园内网部署，我在项目中担任系统架构师职务，主要负责系统整体架构设计，该系统主要完成题目管理、程序提交、自动评测和运营维护，主要功能模块包括账号权限、题库管理、提交评测、执行调度、文件存储以及通知公告等。

在架构工作开始阶段，我们便意识到，架构风格是一组设计原则，是能够提供抽象框架模式，可以为我们的项目提供通用解决方案的，这种能够极大提高软件设计的重用的方法加快我们的建设进程，因此在我司总工程师的建议下，我们使用了解释器风格、独立构件隐式调用风格以及 B/S 风格这三种较常用风格。虚拟机风格中的解释器能够把多样的程序执行过程抽象为统一语义，这类风格非常适用于输入形式多、评测规则相对稳定的场景。独立构件风格包括显式调用与隐式调用，我们为了降低提交入口与评测执行之间的耦合采用了隐式调用，通过消息中间件控制系统间信息交互，不仅能削峰填谷，而且还提高了执行节点扩容和故障隔离的能力。B/S 是基于浏览器与服务器的软件架构，它主要使用超文本传输协议进行通信和交互，简化客户端分发的工作，最终减低了机房批量升级的难度，以下正文将重点描述架构风格的实施过程和效果。

底层架构我们使用解释器风格来满足多语言安全评测需求。解释器风格是虚拟机风格中的一种，具备良好的灵活性，在本项目中我们的架构设计需要兼容多种程序设计语言，一般来说这种软件编写难度非常高，代码维护难度压力也很大，因此这个解释器的设计任务便很明确了，软件设计需要高度抽象、协议的适配由配置文件来承担。具体的做法如下，我们对一次评测过程进行了高度抽象，由于一次评测由很多测试用例组成，每个测试用例容量固定并且标识和数据有明确规定，因此我们将题目中的语言限额和测试用例进行关系建模，将整体题目作为一个根节点，以测试用例作为根节点下的叶子节点，使用结构化配置映射成了题目、限额、用例这三层的数据结构，核心的代码采用模板解析与动态装载生成可执行对象，搭建一套可以基于可变模板的解释器，协议模板的产生可以由语言运行时说明和题目配置进行转换得到，解释器支持协议模板热部署，这种可以将用户程序和测试数据映射成统一的评测对象，将语言差异和数据协议的复杂度简化，后期评测规则更改不会对软件产生影响，仅仅更改协议模板文件即可，最终我们使用了若干份协议描述文件便兼容了这些复杂的语言与用例组合，规避了在业务系统中直接执行用户程序带来的技术风险。

中间层我们使用独立构件风格中的隐式调用来简化构件间的交互复杂度，降低系统耦合度。主要的实现手段是，我们采用了一个开源的消息中间件作为连接构件，这个构件是成熟的消息服务器，其性能和稳定性久经考验。由上文提到的解释器所需的对象化任务经过消息总线分发到各个订阅此消息的应用系统，这些应用系统包括提交服务、评测服务、重试服务等，这种多 web 应用的情况非常适合采用消息发布与消息订阅的机制，能够有效解决耦合问题，我们在编码的过程中发现只要采用这种风格的 web 应用，整个迭代过程效率极高，错误率降低，而且我们使用的配置化消息框架，消息队列的管理完全基于配置，清晰简单，维护性良好，例如评测任务主题、延迟重试主题、异常死信主题等消息队列分类清晰，可以随时修改其结构也能够随时增加其他主题的消息队列，不同的 web 系统监听的队列也可以随时变换组合，基于消息中间件的架构设计能够让系统的构件化思路得到良好实施，总体来说这种架构风格带来了非常清晰的数据流转架构，简化了编码难度，减低本项目的二次开发的难度。

应用系统层我们主要采用 B/S 的架构风格，主要用于解决终端分散、难以统一升级的问题。校园应用有一个明显的特点，机房、办公室和竞赛场地分布在不同楼宇，路途很远，且都是内网通讯，部分场所也是走的受控网络，一般是无法远程支持的，这给我们的系统推广以及后期维护带来了很大难题，我们可以想象如果使用 C/S 架构，更新客户端一旦遇到问题很可能需要运维把各机房跑一遍。这让我们在系统推广和维护方面面临较大压力。我们采用的 B/S 架构风格能够解决这个难题，并充分考量了现在相关技术的成熟度，例如现在的浏览器完全能够实现以前客户端的功能，项目中我们使用了大量的动态页面与脚本技术，能够满足在线编辑、结果查询和后台管理等需求。这种风格中页面和逻辑处理存储在 web 服务器上，维护和软件升级只要更新服务器端即可，及时生效，用户体验较好，例如界面上需要优化，改一下页面或者样式文件就可以马上看到效果了。

项目于 2026 年 6 月完成验收，这半年内共经历了三次大批量集中提交，这几次接入过程平稳顺利，其中协议解释器软件性能没有出现过问题，消息中间件的性能经过多次调优吞吐量也接近了磁盘与网络的承载上限，满足当前的消息交互总量，另外由于我们的项目多次在紧急状态下能够快速适应评测规则变动，得到过业主的邮件表扬。除了业主机房几次突发性的网络故障外，项目至今还未有重大的生产事故，项目组现在留 2 个开发人员和 1 个售后在维护，系统的维护量是可控的，系统运行也比较稳定。

不足之处有两个方面，第一在架构设计的过程中我们忽略了部分机房终端的兼容性，个别终端因为需要兼容老的应用软件不允许系统升级，这些终端系统老旧，其浏览器不支持现有页面技术，导致了系统推广障碍。第二在高可用方面还有待改善。针对第一种问题，我们通过沟通协商说服业主新购 PC，采用两台机器同时使用方式解决。针对第二种问题我方采用了多节点互备和服务接管等策略，在一台服务暂停的情况下，另外一台服务接管，以增加可用性。

计算机系统 = 硬件 + 软件

系统分类维度：

计算机硬件

计算机硬件组成

冯·诺依曼体系结构是现代计算机的基础，由数学家约翰·冯·诺依曼于1945年提出。它的核心思想可以概括为一句话：

程序和数据都存储在同一个存储器中，计算机按照存储的程序顺序自动执行指令。

冯·诺依曼体系结构的五大部件

| 部件 | 英文 | 功能 |
|

摘要

【项目起止时间】，我参与了【项目名称】的研发。该项目的目标是建立一个【系统定位】，该平台旨在【核心功能】，为【业务对象】提供【业务目标】等服务。我在该项目中担任【角色】，全程参与了系统的分析规划和设计工作。本文以该项目为例，详细探讨【论文主题，如软件架构风格 / 高可用性设计 / 信息安全体系】在软件系统架构中的应用及其实现。

在构建【系统名称】时，我们采用了【总体方案，如分层组合 / 主备加集群 / 纵深防御】，【要点A】能够【作用A】，确保【价值A】；而【要点B】则对【对象B】进行【作用B】，提供了【价值B】。这两层结构相互补充，使得平台既能满足【需求A】，又能进行【需求B】。通过【手段A】进行【处理A】，结合【手段B】进行【处理B】，我们成功打造了一个【系统特性】的【系统类型】。通过这一实践，我们进一步验证了【论文主题】在现代软件系统架构中的重要性和实用性。

在我的带领下，项目实施的非常顺利，于【上线时间】成功上线运行，并获得【评价主体】的一致好评。

正文

随着【行业趋势或业务矛盾】，原有【旧做法】已难以支撑【新约束，如并发、安全、扩展】。公司自【年】年【月】月起【调研 / 立项准备】，规划【建设目标】。

【年】年【月】月我司受托建设本项目。本项目【部署与范围一句话】，我在项目中担任系统架构师职务，主要负责系统整体架构设计，该系统主要完成【业务能力】，主要功能模块包括【模块一】、【模块二】、【模块三】、【模块四】以及【模块五】等。

在架构工作开始阶段，我们便意识到，【论文主题对应的方法，如架构风格 / 质量属性策略】是一组设计原则，是能够提供抽象框架模式，可以为我们的项目提供通用解决方案的，这种能够极大提高软件设计的重用的方法加快我们的建设进程，因此在我司总工程师的建议下，我们使用了【论点一】、【论点二】以及【论点三】这三种较常用【风格 / 策略 / 措施】。【类别一】中的【论点一】能够【能力一】，这类方法非常适用于【适用场景】。【类别二】包括【子类A】与【子类B】，我们为了【设计目标】采用了【论点二】，通过【关键机制】控制系统间信息交互，不仅能【收益一】，而且还提高【收益二】。【论点三】是基于【基本形态】的软件架构，它主要使用【通信方式】进行通信和交互，简化【被简化的工作】，最终减低了【被降低的难度】，以下正文将重点描述【论文主题】的实施过程和效果。

底层（或第一方面）我们使用【论点一】来满足【需求一】。【论点一】是【所属类别】中的一种，具备【主要优点】，在本项目中我们的架构设计需要兼容【多变部分】，一般来说这种软件编写难度非常高，代码维护难度压力也很大，因此这个设计任务便很明确了，软件设计需要高度抽象、【变化点】的适配由配置来承担。具体的做法如下，我们对【核心对象】进行了高度抽象，由于【核心对象】由很多【组成单元】组成，每个【组成单元】容量固定并且标识和数据有明确规定，因此我们将【主体】中的【属性甲】和【属性乙】进行关系建模，将整体【主体】作为一个根节点，以【组成单元】作为根节点下的叶子节点，使用结构化配置映射成了【层次名称】这【层数】层的数据结构，核心的处理采用【解析 / 装载 / 调度】生成统一对象，搭建一套可以基于可变模板（或策略）的实现，模板或策略可由【来源】转换得到，并支持热更新。这种可以将【复杂输入】映射成统一对象的做法，将【差异点】的复杂度简化，后期规则更改不会对软件产生影响，仅仅更改配置即可，最终我们使用了若干份描述文件便兼容了这些复杂的【差异组合】，规避了【直接硬编码或危险做法】带来的技术风险。

中间层（或第二方面）我们使用【论点二】来简化【协作对象】间的交互复杂度，降低系统耦合度（或提升【目标质量属性】）。主要的实现手段是，我们采用了【中间件或机制】作为连接构件，这个构件【一句话定位】，其性能和稳定性久经考验。由上文处理得到的对象化数据经过【通道】分发到各个【订阅方 / 协作方】，这些应用系统包括【系统甲】、【系统乙】、【系统丙】等，这种多应用协作的情况非常适合采用【发布订阅 / 异步解耦 / 其他机制】，能够有效解决耦合问题，我们在编码的过程中发现只要采用这种方法，整个迭代过程效率极高，错误率降低，而且我们使用的配置化方式，管理完全基于配置，清晰简单，维护性良好，例如【通道甲】、【通道乙】、【通道丙】等分类清晰，可以随时修改其结构也能够随时增加其他通道，不同系统监听的范围也可以随时变换组合。总体来说这种方法带来了非常清晰的数据流转架构，简化了编码难度，减低本项目的二次开发的难度。

应用系统层（或第三方面）我们主要采用【论点三】，主要用于解决【推广或使用上的难题】。【业务场景】有一个明显的特点，【使用方】分布在【地理或组织范围】，路途很远，且都是【网络条件】，【部分场所】也是走的【受控网络】，一般是无法远程支持的，这给我们的系统推广以及后期维护带来了很大难题，我们可以想象如果使用【被否定的方案】，更新一旦遇到问题很可能需要【运维代价】。这让我们在系统推广和维护方面面临较大压力。我们采用的【论点三】能够解决这个难题，并充分考量了现在相关技术的成熟度，例如现在的【成熟技术】完全能够实现以前【旧方案】的功能，项目中我们使用了大量的【技术甲】与【技术乙】，能够满足【交互需求】等需求。这种做法中【变更集中位置】在服务器侧，维护和软件升级只要更新服务器端即可，及时生效，用户体验较好，例如界面或规则上需要优化，改一下【页面 / 配置 / 策略】就可以马上看到效果了。

项目于【年】年【月】月完成验收，这【时长】内共经历了【若干次业务高峰或变更】，这几次过程平稳顺利，其中【论点一对应部件】性能没有出现过问题，【论点二对应部件】经过多次调优也满足当前的交互总量，另外由于我们的项目多次在紧急状态下能够快速适应【规则或接口变动】，得到过业主的邮件表扬。除了业主侧几次突发性的网络故障外，项目至今还未有重大的生产事故，项目组现在留【n】个开发人员和【m】个售后在维护，系统的维护量是可控的，系统运行也比较稳定。

不足之处有两个方面，第一在架构设计的过程中我们忽略了【兼容性或范围遗漏】，个别【终端 / 子系统】因为需要兼容老的应用软件不允许系统升级，这些【对象】系统老旧，其【运行环境】不支持【新能力】，导致了系统推广障碍。第二在【高可用 / 性能 / 安全等另一质量属性】方面还有待改善。针对第一种问题，我们通过沟通协商说服业主【更换或隔离旧环境】，采用【过渡方案，如两套环境并存】方式解决。针对第二种问题我方采用了【措施甲】和【措施乙】等策略，在一台服务暂停的情况下，另外一台服务接管，以增加可用性。

YOLO 模式主要通过两种方式开启：命令行参数和配置文件。

开启 YOLO 模式意味着将 AI 的操作权限完全放开，这虽然能极大提升效率，但也存在不小的风险。

速览

| 工具 | 对应的 YOLO 标志 | 说明 |
| :

在 Windows 上用 Cursor 打开 WSL 项目时，左下角一直转圈，等待比较久......好像也没有安装好，检查 ~/.cursor-server/bin/ 目录，发现 commit id 的目录是空的，说明自动下载失败了。这在国内网络环境下应该常见，因为服务器文件有 125MB，可能下载中途断掉了。

为什么会有这个问题

Cursor 连接 WSL（或远程 SSH）时，需要在 WSL 内安装一个服务端组件 cursor-server，它本质上是 VSCode Remote 的定制版。自动下载流程大致是：

1. Cursor Windows 端发起 WSL 连接
2. WSL 端根据 commit ID 下载对应的 vscode-reh-linux-x64.tar.gz
3. 解压到 ~/.cursor-server/bin/<commit-id>/
4. 启动 server，建立通信

第二步在国内网络环境下经常超时或中断，下载失败后 bin/<commit-id>/ 目录是空的，但 .installation_lock 文件被写入了，导致 Cursor 以为"正在安装中"，不会重试。

手动安装步骤

找到当前 Cursor 版本的 commit ID

Commit ID 在 Cursor 的版本里，命令：

cursor --version

输出：

"55434bd8062ece6fee083b82beed2aee42d253f0"

记下这串 commit ID，后面都要用到。

确认下载 URL

在安装目录中，/mnt/c/Users/jiang/AppData/Local/Programs/cursor/resources/app/product.json （实际情况依据你安装的目录） product.json 里定义了下载地址模板：

"serverDownloadUrlTemplate": "https://cursor.blob.core.windows.net/remote-releases/${commit}/vscode-reh-${os}-${arch}.tar.gz"

对 Linux x64 来说，最终的 URL 就是：

https://cursor.blob.core.windows.net/remote-releases/<commit-id>/vscode-reh-linux-x64.tar.gz

先用 curl 确认能访问（WSL下）：

curl -sI "https://cursor.blob.core.windows.net/remote-releases/55434bd8062ece6fee083b82beed2aee42d253f0/vscode-reh-linux-x64.tar.gz" | head -5

返回 HTTP/1.1 200 OK 就没问题。

下载并解压

# 下载（如果网络慢，可以用代理或者挂在后台慢慢下）
curl -L -o /tmp/cursor-server.tar.gz \
  "https://cursor.blob.core.windows.net/remote-releases/55434bd8062ece6fee083b82beed2aee42d253f0/vscode-reh-linux-x64.tar.gz"

# 解压到对应 commit 目录
mkdir -p ~/.cursor-server/bin/55434bd8062ece6fee083b82beed2aee42d253f0
tar -xzf /tmp/cursor-server.tar.gz \
  -C ~/.cursor-server/bin/55434bd8062ece6fee083b82beed2aee42d253f0/

# 如果解压后多了一层目录，把内容移上来
cd ~/.cursor-server/bin/55434bd8062ece6fee083b82beed2aee42d253f0/
ls  # 确认是不是直接包含了 bin、node_modules 等目录
    # 如果只有一个子目录，把内容移上来
mv vscode-reh-linux-x64/* .
mv vscode-reh-linux-x64/.* . 2>/dev/null
rmdir vscode-reh-linux-x64

# 清理临时文件
rm /tmp/cursor-server.tar.gz

清理安装锁文件

这是关键一步。Cursor 在下载开始时写入了 .installation_lock，如果不删掉，它不会检测到 server 已经装好：

rm -f ~/.cursor-server/.installation_lock*

验证安装

~/.cursor-server/bin/55434bd8062ece6fee083b82beed2aee42d253f0/bin/cursor-server --version

输出：

版本号和 commit ID 对上，说明安装成功了。

重新连接

回到 Cursor Windows 端，点击左下角 >< 图标，重新连接 WSL。这次应该秒连，不再卡在安装步骤。

如果 Cursor 更新了版本

每次 Cursor 更新版本，commit ID 会变，需要重新安装对应的 server。流程一样：

1. 查新的 commit ID
2. 下载对应的 vscode-reh-linux-x64.tar.gz
3. 解压到新的 bin/<new-commit-id>/
4. 清理 lock 文件

我习惯把下载包留一份，或者写个脚本一键搞定：

#!/bin/bash
COMMIT=$(grep -o '"commit"[^,]*' "/mnt/e/Users/jiang/AppData/Local/Programs/cursor/resources/app/product.json" | cut -d'"' -f4)
echo "Commit: $COMMIT"

mkdir -p ~/.cursor-server/bin/$COMMIT

curl -L -o /tmp/cursor-server.tar.gz \
  "https://cursor.blob.core.windows.net/remote-releases/$COMMIT/vscode-reh-linux-x64.tar.gz"

tar -xzf /tmp/cursor-server.tar.gz -C ~/.cursor-server/bin/$COMMIT/
# 处理嵌套目录
if [ -d "$HOME/.cursor-server/bin/$COMMIT/vscode-reh-linux-x64" ]; then
  mv ~/.cursor-server/bin/$COMMIT/vscode-reh-linux-x64/* ~/.cursor-server/bin/$COMMIT/
  rmdir ~/.cursor-server/bin/$COMMIT/vscode-reh-linux-x64
fi

rm -f ~/.cursor-server/.installation_lock*
rm /tmp/cursor-server.tar.gz

echo "Done"

THE END

| 步骤 | 命令 |
|

机器上同时有三套 Python 很容易搅在一起：

1. 系统自带的 /usr/bin/python3
2. conda 的 base
3. 自己建的业务 / 学习环境

想要的结果很简单：不管终端还是 Cursor，一律只用名为 normal 的 conda 环境，不要再落到 base 或系统 Python 上。

下面以 miniforge（路径 /home/charlie/miniforge3）为例，过程对 Anaconda / Miniconda 同样适用，改一下前缀即可。

创建 normal 环境

选用相对稳妥的 3.12：

conda create -n normal python=3.12 -y

创建完成后确认：

conda env list
# base                     /home/charlie/miniforge3
# normal                   /home/charlie/miniforge3/envs/normal

解释器路径固定为：

/home/charlie/miniforge3/envs/normal/bin/python

网络不稳时下载可能被 Connection reset by peer 打断，直接重跑同一条 conda create 即可，已下完的包会复用缓存。

关掉 base 自动激活

默认安装后，新开 shell 会进 base。先关掉：

conda config --set auto_activate_base false

新版 conda 会把这个键写成 auto_activate。~/.condarc 里最终可以是：

auto_activate: false

这样登录时不会再默认进 base。

让 bash 登录后自动进 normal

在 ~/.bashrc 的 conda initialize 块末尾加上激活语句：

# >>> conda initialize >>>
__conda_setup="$('/home/charlie/miniforge3/bin/conda' 'shell.bash' 'hook' 2> /dev/null)"
if [ $? -eq 0 ]; then
    eval "$__conda_setup"
else
    if [ -f "/home/charlie/miniforge3/etc/profile.d/conda.sh" ]; then
        . "/home/charlie/miniforge3/etc/profile.d/conda.sh"
    else
        export PATH="/home/charlie/miniforge3/bin:$PATH"
    fi
fi
unset __conda_setup
# Always use the `normal` env (never conda base / system Python)
conda activate normal 2>/dev/null
# <<< conda initialize <<<

要点：

• 必须写在 conda hook 初始化之后，否则 conda activate 可能不可用
• 2>/dev/null 避免环境尚未创建时刷一堆报错
• 新开终端后提示符应显示 (normal)

已打开的旧终端不会自动生效，手动执行一次：

conda activate normal

让 Cursor 也指向 normal

只改 shell 不够，编辑器里跑 Python / 选解释器时仍可能跳到别的环境。在 Cursor 用户设置里加上：

{
  "python.defaultInterpreterPath": "/home/charlie/miniforge3/envs/normal/bin/python",
  "python.terminal.activateEnvironment": true,
  "terminal.integrated.env.linux": {
    "CONDA_DEFAULT_ENV": "normal"
  }
}

路径按本机 conda 前缀调整。改完后重开集成终端，或在命令面板里重新选一次解释器确认。

验收

干净登录测一下（或新开一个终端）：

echo "$CONDA_DEFAULT_ENV"   # 期望：normal
which python                # .../envs/normal/bin/python
python --version            # Python 3.12.x
conda env list              # normal 前有 *

再确认没有误用系统解释器：

command -v python
command -v python3
# 两者都应落在 .../envs/normal/bin/ 下

系统里的 /usr/bin/python3 可以还在，但只要 PATH 里 normal 在前，日常敲 python / python3 就不会撞上它。

The End

| 项 | 做法 |
|

写博客的时候用 Obsidian 插了张图：

![img](assets/example.jpg)

编辑器里看着好好的，一跑 hugo 部署上去，图裂了。打开浏览器开发者工具一看，图片请求的路径根本就不对。

检查了一圈，发现这个问题只出现在 非 bundle 的 md 文件 上，用目录包起来的 index.md 反倒没事。

为什么会有这个问题

Hugo 的两种页面

Hugo 里写文章有两种姿势：

1. Page Bundle — 建个文件夹，里面放 index.md，图片丢同目录下

content/posts/my-post/
├── index.md
└── some-image.jpg

2. Leaf Page — 直接一个 .md 文件

content/posts/my-post.md

我这边的目录结构是这样的：

content/posts/
├── _index.md
├── assets/
│   └── example.jpg
├── my-post.md              ← 出问题的
└── my-bundle-post/
    └── index.md            ← 没问题的

Blowfish 主题自带的图片渲染逻辑，会先用 $.Page.Resources.GetMatch 去捞图片。Bundle 页面自然能捞到，但 leaf page 压根没有 page resources，捞了个空。最后 fallback 到直接把原始相对路径当 src 输出——这就是问题的起点。

Permalink 让路径更深了一層

我的 permalink 配的是：

permalinks:
  posts: /posts/:year/:month/:day/:slug/

假设文件是 content/posts/my-post.md，生成的页面 URL 是 /posts/2026/06/05/my-post/。

Leaf page 里的 ![img](assets/example.jpg)，浏览器会以页面 URL 为基准去解析：

页面地址: /posts/2026/06/05/my-post/
浏览器请求: /posts/2026/06/05/my-post/assets/example.jpg   ← 404

但图片实际在哪？在 content/posts/assets/example.jpg。Hugo 构建的时候会把 content 目录下的非内容文件也发布出去，所以这张图实际是：

public/posts/assets/example.jpg

问题就是：leaf page 在 URL 里多了好几层目录，但图片的相对路径没跟着变。

怎么修的

方案一：改成 Page Bundle（最推荐）

最省事的做法就是把 leaf page 改成 bundle：

# 改之前
content/posts/my-post.md
content/posts/assets/example.jpg

# 改之后
content/posts/my-post/index.md
content/posts/my-post/assets/example.jpg

这样 $.Page.Resources.GetMatch 能找到图片，而且 Blowfish 的 responsive 图片优化也会生效。缺点是每个文章都要建目录，已有的存量文章多了有点折腾。

方案二：写个 render hook 兜底（我用的方案）

参考了 Joker 的文章，但里面用的 ../ 补丁只适合单层目录，我的 permalink 太深了不管用。改成了拼绝对路径。

在 layouts/_default/_markup/render-image.html 里覆写了 Blowfish 的图片渲染逻辑：

{{- if not $isRemote -}}
  {{- $isPageBundle := eq $.Page.File.LogicalName "index.md" -}}
  {{- if $isPageBundle -}}
    {{- /* bundle: 原样走主题的逻辑 */ -}}
    {{- $resource = or ($.Page.Resources.GetMatch $urlStr) (resources.Get $urlStr) -}}
  {{- else if not (strings.HasPrefix $urlStr "/") -}}
    {{- /* leaf page + 相对路径: 用 .File.Dir 拼出正确路径 */ -}}
    {{- $correctPath := path.Join $.Page.File.Dir $urlStr -}}
    {{- $resource = or ($.Page.Resources.GetMatch $correctPath) (resources.Get $correctPath) -}}
    {{- if not $resource -}}
      {{- $urlStr = printf "/%s" $correctPath -}}
    {{- end -}}
  {{- else -}}
    {{- $resource = or ($.Page.Resources.GetMatch $urlStr) (resources.Get $urlStr) -}}
  {{- end -}}
{{- end -}}

核心逻辑就几件事：

1. 先判断是不是 bundle（看 LogicalName 是不是 "index.md"）
2. 不是 bundle，而且图片路径是相对路径——就用 .Page.File.Dir 拼出内容目录下的绝对路径
3. 试着找一下图片资源，找不到就直接用绝对路径当 src

path.Join "posts/" "assets/example.jpg" → posts/assets/example.jpg → /posts/assets/example.jpg

这样不管 permalink 多深，路径都不会偏。

验证

修之前：

<img src="/posts/2026/06/05/my-post/assets/example.jpg">
<!-- 404 -->

修之后：

<img src="/posts/assets/example.jpg">
<!-- 200 -->

实际效果：

这张图就是 leaf page 引的，能正常显示说明修好了。

几个需要注意的

• 参考文章的方案不适用于深层 permalink：他直接在相对路径前面加 ../，只退一层。本项目的 /:year/:month/:day/:slug/ 叠了四层，必须用绝对路径
• Leaf page 没有图片优化：Page bundle 的图片会被 Blowfish 做 responsive resize（生成多尺寸 + srcset），leaf page 的图不会。如果对图片体积有要求，还是推荐 bundle
• 我这修复只动了 render hook：不影响 bundle 页面，不影响远程图片，不影响已经用了绝对路径的图片

总结

| 维度 | Page Bundle | Leaf Page + render hook |
|

本文环境：Linux，主题目录 ~/.config/Typora/themes/（Windows 一般在 %APPDATA%\Typora\themes\，macOS 在 ~/Library/Application Support/abnerworks.Typora/themes/）。

为什么要复制一份主题

主题目录里的 Readme.md 写得很清楚：内置 CSS 更新或重装后会被替换，不要直接改内置主题。

正确姿势见官方文档：

• About Themes
• Add Custom CSS
• Auto Numbering

目标文件结构：

~/.config/Typora/themes/
├── github.css              ← 内置，不动
├── github/                 ← 内置字体，不动
├── github-cus.css          ← 自定义主题入口
└── github-cus/             ← 字体资源（从 github/ 复制）

Typora 主题名取自 CSS 文件名：github-cus.css → 主题选择器里一般显示为 Github Cus。

从 github 复制出 github-cus

THEMES="$HOME/.config/Typora/themes"

cp "$THEMES/github.css" "$THEMES/github-cus.css"
cp -a "$THEMES/github" "$THEMES/github-cus"

# 字体路径从 ./github/ 改到 ./github-cus/
sed -i "s|url('./github/|url('./github-cus/|g" "$THEMES/github-cus.css"

复制后 @font-face 应类似：

src: local('Open Sans Regular'), local('OpenSans-Regular'),
     url('./github-cus/open-sans-v17-latin-ext_latin-regular.woff2') format('woff2');

然后在 Typora：主题 → Github Cus。后面所有改动都只动 github-cus.css。

行内代码改成掘金风格

目标效果

正文里的 `Integer` 一类行内代码：

• 字色：#ff502c（橙红）
• 背景：rgba(255, 80, 44, 0.1)（淡橙红底）
• 无边框、小圆角、左右略留白

围栏代码块（```）继续用原来的灰底，不要跟行内代码混成同一种颜色。

原主题怎么写的

github 主题里行内代码和围栏代码块绑在一起：

.md-fences,
code,
tt {
    border: 1px solid #e7eaed;
    background-color: #f8f8f8;
    border-radius: 3px;
    padding: 2px 4px 0px 4px;
    font-size: 0.9em;
}

code {
    background-color: #f3f4f4;
    padding: 0 2px 0 2px;
}

问题在于：改 code 会连带影响 .md-fences 里的 code，所以必须拆开，并给围栏内部做还原。

替换成下面这段

在 github-cus.css 里，把上面那段改成：

/* Inline code — Juejin style */
code,
tt {
    margin: 0 2px;
    padding: 2px 4px;
    border: none;
    border-radius: 2px;
    background-color: rgba(255, 80, 44, 0.1);
    color: #ff502c;
    font-size: 0.9em;
    font-family: Consolas, Monaco, "Courier New", monospace;
}

.md-fences {
    margin-bottom: 15px;
    margin-top: 15px;
    padding: 8px 4px 6px;
    border: 1px solid #e7eaed;
    border-radius: 3px;
    background-color: #f8f8f8;
    font-size: 0.9em;
    color: inherit;
}

.md-fences code,
.md-fences tt {
    margin: 0;
    padding: 0;
    border: none;
    border-radius: 0;
    background-color: transparent;
    color: inherit;
    font-size: inherit;
}

要点：

1. 只给裸 code / tt 上掘金色
2. .md-fences 单独保留灰底围栏样式
3. .md-fences code 清掉颜色和背景，避免代码块里每个 token 都变橙红

改完后重选一次主题，或重启 Typora。

正文标题自动编号（从 h2 起）

需求

文章一般是「一级标题当文题，正文从二级开始分节」：

| Markdown | 显示 |
|

下载 VMware Workstation Pro 26H1

Broadcom 注册地址：https://profile.broadcom.com/web/registration
Broadcom 登录地址：https://access.broadcom.com/default/ui/v1/signin/

下载入口：

https://support.broadcom.com/group/ecx/productdownloads?subfamily=VMware%20Workstation%20Pro&freeDownloads=true

选择对应版本

I agree to the Terms and Conditions

这个按钮可能有时候点击不了，多试几次

可能需要填写一些信息：

开始安装

机器是一台日常开发本：Debian GNU/Linux 13 (trixie) + XFCE，硬件是 HP ProBook，双 NVMe，本机还跑着 Docker（MySQL / Redis / Portainer 等）。

一次顺手整理，把几件容易踩坑的事一起做完：

1. 关掉自动熄屏 / 挂起（插电、电池都关）
2. 看清「要不要更新」，以及为什么 apt 会甩出一千多个可升级包
3. 注释掉 sid / bullseye 混源，只做安全范围内的升级
4. 弄清 XApp / AppMenu，装上全局菜单并让它对齐、能导出菜单
5. 看资源占用，给开发机开防火墙（默认不让别的设备访问）

下面按实际操作顺序写，命令可直接复用。

XFCE：关掉自动熄屏和挂起

电源管理 GUI

打开：

xfce4-power-manager-settings

重点看两个标签，且 On battery / Plugged in 都要改：

• System：When inactive for → Never
• Display：Put to sleep after / Switch off after → Never
  更干净的做法：直接关掉 Display power management 总开关

Devices 标签只显示电池信息，没有熄屏相关选项。

屏保

本机没有 xfce4-screensaver（command not found 很正常），可以忽略。真正黑屏多半来自电源管理或 DPMS。

DPMS（硬件级熄屏）

终端立刻关掉：

xset s off
xset -dpms
xset s noblank

想开机也生效：在 设置 → 会话和启动 → 应用程序自动启动 加一条：

xset s off -dpms s noblank

也可用 xfconf 关掉电源管理侧的 DPMS：

xfconf-query -c xfce4-power-manager -p /xfce4-power-manager/dpms-enabled -s false
xfconf-query -c xfce4-power-manager -p /xfce4-power-manager/blank-on-ac -s 0
xfconf-query -c xfce4-power-manager -p /xfce4-power-manager/blank-on-battery -s 0

系统要不要更新：先看源，再看数量

表面现象

apt list --upgradable

一度出现 一千多个 可升级包，内核候选版本甚至从 6.12 跳到 7.x。这不是「trixie 落后很多」，而是软件源混了。

实际系统状态（整理前）

| 项 | 状态 |
|

机器：Debian 13（trixie）+ XFCE，原先用 LightDM + lightdm-gtk-greeter。

要做的事：

1. 登录界面换成 GDM3（只要登录页，不换 GNOME 桌面）
2. 登录后仍进 Xfce Session
3. 能用图形工具调登录页外观（壁纸等）
4. 搞清楚 登录头像 改哪里、为什么 Mugshot / 只改 ~/.face 不生效

明确不做（本文范围外）：

• 不装 WhiteSur / macOS 风 GDM 主题（可以后再加）
• 不卸载 LightDM 包（方便回退）

桌面侧其它整理可对照：[Debian 13 XFCE 开发机整理：熄屏、软件源、全局菜单与防火墙](./2026-10-01-Debian 13 XFCE 开发机整理：熄屏、软件源、全局菜单与防火墙.md)。

环境：Debian 13 (trixie) · GNOME · X11（gnome-xorg）
目标：Fcitx5 + Rime，默认方案 luna_pinyin_simp（月拼音·简体），登录自动启动。

原先系统是 IBus + ibus-libpinyin。不卸载 IBus（GNOME 有依赖），改用 im-config 切到 Fcitx5。

• 已配好 Debian 软件源（见 配置 Debian 软件源）
• 确认代号：

. /etc/os-release && echo "$VERSION_CODENAME"
# 本文按 trixie 写；bookworm 等把下面 URL 里的代号一并改掉

不要用发行版仓库里过时的 docker.io 凑合（可以跑，但版本和管理源往往不如官方 CE 清晰）。开发机推荐 Docker CE + 国内镜像。

依赖与 GPG 密钥

sudo apt update
sudo apt install -y ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

若阿里云 GPG 地址异常，可用 Docker 官方密钥再继续用阿里云软件源（密钥与仓库可分开）。

添加阿里云 Docker CE 源

. /etc/os-release
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.aliyun.com/docker-ce/linux/debian ${VERSION_CODENAME} stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list

Debian 13 上生效后类似：

deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.aliyun.com/docker-ce/linux/debian trixie stable

安装 Docker Engine

sudo apt update
sudo apt install -y \
  docker-ce \
  docker-ce-cli \
  containerd.io \
  docker-buildx-plugin \
  docker-compose-plugin

开机自启并立刻启动：

sudo systemctl enable --now docker
sudo systemctl status docker --no-pager

当前用户免 sudo

sudo usermod -aG docker "$USER"

注销重新登录（或重启）后再测：

docker version
docker run --rm hello-world

配置镜像加速（拉镜像用）

把加速器写进 daemon 配置（示例为阿里云；也可换中科大、DaoCloud 等）：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json >/dev/null <<'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io"
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "50m",
    "max-file": "3"
  }
}
EOF

sudo systemctl daemon-reload
sudo systemctl restart docker
docker info | grep -A5 'Registry Mirrors'

加速器地址会随服务商变更，以你账号控制台或镜像站文档为准。

常用自检

docker info
docker compose version
docker ps -a

数据盘与项目目录建议分开，例如：

mkdir -p ~/Workspace/datas

容器业务数据（MySQL、Redis、对象存储等）优先 bind 到 ~/Workspace/datas/...，不要只依赖匿名卷，方便备份和迁移。

和防火墙的关系（开发机）

UFW 默认拒入站时，Docker 映射到 0.0.0.0 的端口仍可能被局域网访问（走 FORWARD/DNAT，不经 UFW 的 INPUT）。开发本若只想本机用：

• 映射写成 -p 127.0.0.1:3306:3306，或
• 在 DOCKER-USER 链限制外网访问（见 XFCE 开发机整理一文中的防火墙小节）

小结

| 步骤 | 要点 |
|

本文要装的是 Oracle MySQL 和 Redis，不是 MariaDB。

Debian 自带仓库里的 default-mysql-server 实际会装成 MariaDB，不要用那个包。本机用 apt 装 MySQL 时，走 MySQL 官方 APT 源。

| 方式 | Redis | MySQL |
|

顶栏装了 AppMenu Plugin 之后：

• 菜单标题（如 Cursor、Thunar）不靠左，像漂在面板中间
• 右键属性里把 Expand plugin on panel 关掉，看起来正常了
• 注销 / 重启 后，Expand 又被勾上，标题又居中

装全局菜单、环境变量、GTK module 等前置步骤见：[Debian 13 XFCE 开发机整理：熄屏、软件源、全局菜单与防火墙](./2026-10-01-Debian 13 XFCE 开发机整理：熄屏、软件源、全局菜单与防火墙.md)。本文只挖 居中 / Expand 反复写回 这一块。

新装或刚到手的 Debian 开发机，先把「能正常干活」的底子铺好，再去改软件源、装 Docker、跑 MySQL / Redis。

本文以 Debian 13 (trixie) + 图形桌面（如 XFCE） 为例，命令对服务器版同样适用（跳过桌面相关即可）。

建议阅读顺序：

1. 本文：01 Linux 初始机
2. 配置 Debian 软件源
3. Debian 中国源安装 Docker
4. Debian 安装 Redis 和 MySQL

确认系统

cat /etc/os-release
uname -r
hostnamectl

关注：

• VERSION_CODENAME（如 trixie）——后面写源、装 Docker 都要用
• 架构一般为 x86-64 / amd64

用户与 sudo

安装时若已创建普通用户并勾选 sudo，可跳过。否则：

su -
apt update
apt install -y sudo
usermod -aG sudo 你的用户名

注销重登后验证：

sudo -v
whoami

开发机建议：日常用普通用户，需要提权再 sudo，不要长期挂在 root 图形会话里。

基础工具包

sudo apt update
sudo apt install -y \
  curl wget ca-certificates gnupg \
  git vim htop tree unzip \
  net-tools iproute2 dnsutils \
  build-essential \
  lm-sensors

按需再加：

# 压缩 / 磁盘
sudo apt install -y p7zip-full ncdu

# 终端体验
sudo apt install -y tmux fzf ripgrep

时区与语言

# 时区（上海）
sudo timedatectl set-timezone Asia/Shanghai
timedatectl

# 中文环境（桌面常用）
sudo apt install -y locales
sudo dpkg-reconfigure locales
# 勾选 zh_CN.UTF-8，并设为默认

当前 shell 可先：

echo 'export LANG=zh_CN.UTF-8' >> ~/.bashrc

目录习惯（开发机）

后面 Docker 数据、项目都会落到固定路径，建议一开始就定好，例如：

mkdir -p ~/Workspace/{projects,datas}
mkdir -p ~/Workspace/datas/{mysql,redis,silo,ngnix}

约定示例：

| 路径 | 用途 |
|

默认 deb.debian.org 在国内经常慢或不稳。开发机建议：

• 软件包、更新、backports → 中科大镜像（也可换清华、北外、阿里云等）
• 安全更新 → 继续用官方 security.debian.org（更及时）

同时要避免把 sid（unstable）、旧版 bullseye 和当前稳定版写进同一套默认源，否则 apt list --upgradable 会刷出上千个包，一不小心就把桌面拖进滚动版。

备份

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak.$(date +%Y%m%d%H%M%S)

确认代号：

. /etc/os-release && echo "$VERSION_CODENAME"
# Debian 13 → trixie

下文以 trixie 为例，其他版本替换代号即可。

推荐的 sources.list

以中国科学技术大学（USTC）镜像为例：

sudo tee /etc/apt/sources.list >/dev/null <<'EOF'
deb https://mirrors.ustc.edu.cn/debian/ trixie main contrib non-free non-free-firmware
deb https://mirrors.ustc.edu.cn/debian/ trixie-updates main contrib non-free non-free-firmware
deb https://mirrors.ustc.edu.cn/debian/ trixie-backports main contrib non-free non-free-firmware

# 安全更新建议走官方
deb https://security.debian.org/debian-security trixie-security main contrib non-free non-free-firmware
EOF

镜像站文档：https://mirrors.ustc.edu.cn/help/debian.html
若改用其他镜像，把主机名换成例如 mirrors.tuna.tsinghua.edu.cn、mirrors.bfsu.edu.cn、mirrors.aliyun.com 即可。

说明：

| 行 | 作用 |
|

# ===== MySQL 9.7.2 =====
docker pull docker.xuanyuan.run/library/mysql:9.7.2; docker tag docker.xuanyuan.run/library/mysql:9.7.2 library/mysql:9.7.2; docker rmi docker.xuanyuan.run/library/mysql:9.7.2

# ===== Redis 8.8.2 =====
docker pull docker.xuanyuan.run/library/redis:8.8.2; docker tag docker.xuanyuan.run/library/redis:8.8.2 library/redis:8.8.2; docker rmi docker.xuanyuan.run/library/redis:8.8.2

# ===== Silo (MinIO 变体) =====
docker pull docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z; docker tag docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z pgsty/silo:RELEASE.2026-08-06T00-00-00Z; docker rmi docker.xuanyuan.run/pgsty/silo:RELEASE.2026-08-06T00-00-00Z

# ===== RabbitMQ 4.2.9-management =====
docker pull docker.xuanyuan.run/library/rabbitmq:4.2.9-management; docker tag docker.xuanyuan.run/library/rabbitmq:4.2.9-management library/rabbitmq:4.2.9-management; docker rmi docker.xuanyuan.run/library/rabbitmq:4.2.9-management

# ===== Ollama 0.33.1 =====
docker pull docker.xuanyuan.run/ollama/ollama:0.33.1; docker tag docker.xuanyuan.run/ollama/ollama:0.33.1 ollama/ollama:0.33.1; docker rmi docker.xuanyuan.run/ollama/ollama:0.33.1


docker pull pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12; docker tag pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12 quay.io/coreos/etcd:v3.6.12; docker rmi pgexh7a70kca8kgghn-quay.xuanyuan.run/coreos/etcd:v3.6.12


docker pull docker.xuanyuan.run/zilliz/attu:v3.0.0; docker tag docker.xuanyuan.run/zilliz/attu:v3.0.0 zilliz/attu:v3.0.0; docker rmi docker.xuanyuan.run/zilliz/attu:v3.0.0

运行命令

# ===== MySQL 9.7.2（开机自启）=====
docker run -d --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/mysql:/var/lib/mysql \
  --restart unless-stopped \
  mysql:9.7.2

# ===== Redis 8.8.2（开机自启 + AOF）=====
docker run -d --name redis \
  -p 6379:6379 \
  -e REDIS_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/redis:/data \
  --restart unless-stopped \
  redis:8.8.2 \
  --requirepass "infra123!" --appendonly yes


# ===== MySQL 9.7.2（开机不自启）=====
docker run -d --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/mysql:/var/lib/mysql \
  --restart no \
  mysql:9.7.2

# ===== Redis 8.8.2（开机不自启 + AOF）=====
docker run -d --name redis \
  -p 6379:6379 \
  -e REDIS_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/redis:/data \
  --restart no \
  redis:8.8.2 \
  --requirepass "infra123!" --appendonly yes


# ===== Silo (MinIO 变体) =====
docker run -d --name silo \
  -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD='infra123!' \
  -v silo_data:/data \
  --restart unless-stopped \
  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
  server /data --console-address ":9001"
  
  
# ===== Silo（默认不自启）=====
docker run -d --name silo \
  -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD='infra123!' \
  -v /home/charlie/Workspace/datas/silo:/data \
  --restart no \
  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
  server /data --console-address ":9001"

# ===== RabbitMQ 4.2.9-management =====
docker run -d --name rabbitmq \
  -p 5672:5672 \
  -p 15672:15672 \
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS='infra123!' \
  -v rabbitmq_data:/var/lib/rabbitmq \
  --restart no \
  rabbitmq:4.2.9-management

# ===== Ollama 0.33.1 =====
docker run -d --name ollama \
  -p 11434:11434 \
  -v ollama_data:/root/.ollama \
  --restart unless-stopped \
  ollama/ollama:0.33.1

# ===== Ollama 0.33.1 =====
docker run -d --name ollama \
  -p 11434:11434 \
  -v ollama_data:/root/.ollama \
  --restart no \
  ollama/ollama:0.33.1
  
# ===== Draw.io 31.4.1 =====
docker run -d --name draw \
  -p 18080:8080 \
  --restart unless-stopped \
  jgraph/drawio:31.4.1
  
docker run -d --name drawio \
  -p 18080:8080 \
  --restart no \
  jgraph/drawio:31.4.2
  
# ===== Nacos 2.5.0 =====
docker run -d --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  --restart unless-stopped \
  -e MODE=standalone \
  nacos/nacos-server:v2.5.0
  
  
  
docker run -d --name nginx \
  -p 8080:80 \
  -v /home/charlie/Workspace/datas/ngnix/conf/nginx.conf:/etc/nginx/nginx.conf:ro \
  -v /home/charlie/Workspace/datas/ngnix/conf/conf.d:/etc/nginx/conf.d:ro \
  -v /home/charlie/Workspace/datas/ngnix/html:/usr/share/nginx/html:ro \
  -v /home/charlie/Workspace/datas/ngnix/logs:/var/log/nginx \
  -v /home/charlie/Workspace/datas/ngnix/ssl:/etc/nginx/ssl:ro \
  --restart no \
  nginx:stable-alpine3.24

运行命令

# ===== MySQL 9.7.2（开机不自启）=====
docker run -d --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD='infra123!' \
  -v mysql_data:/var/lib/mysql \
  --restart no \
  mysql:9.7.2

# ===== Redis 8.8.2（开机不自启 + AOF）=====
docker run -d --name redis \
  -p 6379:6379 \
  -e REDIS_PASSWORD='infra123!' \
  -v redis_data:/data \
  --restart no \
  redis:8.8.2 \
  --requirepass "infra123!" --appendonly yes

# ===== Silo（默认不自启）=====
docker run -d --name silo \
  -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=admin \
  -e MINIO_ROOT_PASSWORD='infra123!' \
  -v silo_data:/data \
  --restart no \
  pgsty/silo:RELEASE.2026-08-06T00-00-00Z \
  server /data --console-address ":9001"

# ===== RabbitMQ 4.2.9-management =====
docker run -d --name rabbitmq \
  -p 5672:5672 \
  -p 15672:15672 \
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS='infra123!' \
  -v rabbitmq_data:/var/lib/rabbitmq \
  --restart no \
  rabbitmq:4.2.9-management

# ===== Ollama 0.33.1 =====
docker run -d --name ollama \
  -p 11434:11434 \
  -v ollama_data:/root/.ollama \
  --restart no \
  ollama/ollama:0.33.1

docker run -d --name drawio \
  -p 18080:8080 \
  --restart no \
  jgraph/drawio:31.4.6
  
# ===== Nacos 2.5.0 =====
docker run -d --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  --restart unless-stopped \
  -e MODE=standalone \
  nacos/nacos-server:v2.5.0
  
  
# ===== Milvus 前置：命名卷写入 etcd 配置 =====
docker volume create milvus_data
docker run --rm -v milvus_data:/var/lib/milvus alpine sh -c 'cat > /var/lib/milvus/embedEtcd.yaml << EOF
listen-client-urls: http://0.0.0.0:2379
advertise-client-urls: http://0.0.0.0:2379
quota-backend-bytes: 4294967296
auto-compaction-mode: revision
auto-compaction-retention: '\''1000'\''
EOF'
# ===== Milvus（开机不自启）=====
docker run -d --name milvus \
  --pull=never \
  --security-opt seccomp:unconfined \
  -e ETCD_USE_EMBED=true \
  -e ETCD_DATA_DIR=/var/lib/milvus/etcd \
  -e ETCD_CONFIG_PATH=/var/lib/milvus/embedEtcd.yaml \
  -e COMMON_STORAGETYPE=local \
  -e DEPLOY_MODE=STANDALONE \
  -v milvus_data:/var/lib/milvus \
  -p 19530:19530 \
  -p 9091:9091 \
  -p 2379:2379 \
  --health-cmd="curl -f http://localhost:9091/healthz" \
  --health-interval=30s \
  --health-start-period=90s \
  --health-timeout=20s \
  --health-retries=3 \
  --restart no \
  milvusdb/milvus:v3.0.1 \
  milvus run standalone
# ===== 开启鉴权，并把 root 密码改为 infra123! =====
docker exec milvus sh -c 'cat > /milvus/configs/user.yaml << EOF
common:
  security:
    authorizationEnabled: true
EOF'
docker restart milvus
# 等 healthy 后执行
curl -sS -X POST "http://127.0.0.1:19530/v2/vectordb/users/update_password" \
  -H "Authorization: Bearer root:Milvus" \
  -H "Content-Type: application/json" \
  -d '{"userName":"root","password":"Milvus","newPassword":"infra123!"}'
# ===== Attu（开机不自启）=====
docker run -d --name attu \
  --pull=never \
  -p 8000:3000 \
  -e MILVUS_URL=http://host.docker.internal:19530 \
  -e ATTU_ADMIN_USER=admin \
  -e ATTU_ADMIN_PASSWORD='infra123!' \
  -v attu_data:/data \
  --add-host=host.docker.internal:host-gateway \
  --restart no \
  zilliz/attu:v3.0.0

采集时间：2026-10-07。主机名 dev。

| 项 | 值 | 依据 |
|

首先创建所有服务的数据持久化目录：

# 创建统一的数据存储目录
mkdir -p ~/docker-data/{postgres,redis,rabbitmq}

服务部署

PostgreSQL（支持向量扩展，端口5433）

# 拉取支持向量扩展的PostgreSQL镜像
docker pull pgvector/pgvector:pg17

# 启动PostgreSQL容器
docker run -d \
  --name postgres \
  --restart unless-stopped \
  -m 512m \
  -e POSTGRES_PASSWORD=123456 \
  -e POSTGRES_DB=myapp \
  -v ~/docker-data/postgres:/var/lib/postgresql/data \
  -p 5433:5432 \
  pgvector/pgvector:pg17

启用向量扩展（首次启动后执行）：

docker exec -it postgres psql -U postgres -d myapp -c "CREATE EXTENSION IF NOT EXISTS vector;"

连接测试：

docker exec -it postgres psql -U postgres -d myapp -c "SELECT 1+1;"
# 返回 ?column? | 2 表示成功

Redis（缓存服务，端口6380）

# 拉取Redis镜像
docker pull redis:7-alpine

# 启动Redis容器
docker run -d \
  --name redis \
  --restart unless-stopped \
  -m 128m \
  -v ~/docker-data/redis:/data \
  -p 6380:6379 \
  redis:7-alpine \
  redis-server --maxmemory 128mb --maxmemory-policy allkeys-lru --requirepass 123456 --appendonly yes

连接测试：

docker exec -it redis redis-cli -a 123456 ping
# 返回 PONG 表示成功

RabbitMQ（消息队列，端口5673/15673）

# 拉取带管理界面的RabbitMQ镜像
docker pull rabbitmq:4-management-alpine

# 启动RabbitMQ容器
docker run -d \
  --name rabbitmq \
  --restart unless-stopped \
  -m 384m \
  -v ~/docker-data/rabbitmq:/var/lib/rabbitmq \
  -p 5673:5672 \
  -p 15673:15672 \
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS=123456 \
  rabbitmq:4-management-alpine

管理界面访问： http://你的IP:15673，账号 admin / 密码 123456

MySQL（备用数据库，端口3307）

如需要MySQL作为备用数据库，可使用以下配置：

# 拉取MySQL镜像
docker pull mysql:8.0

# 启动MySQL容器
docker run -d \
  --name mysql \
  --restart unless-stopped \
  -m 512m \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -e MYSQL_DATABASE=myapp \
  -v ~/docker-data/mysql:/var/lib/mysql \
  -p 3307:3306 \
  mysql:8.0 \
  --innodb_buffer_pool_size=256M