CLAUDE.md

本文件为在这台服务器上工作的 Claude Code 提供上下文。这是一台生产服务器，改动需谨慎。

服务器概览

• OS: Ubuntu 24.04.4 LTS
• 公网/源站 IP: 49.235.116.153
• Nginx: 1.31.1 mainline（官方 APT 源），编译含 --with-http_v2_module、--with-http_v3_module、--with-compat
• SSH: 端口 3223，禁用密码登录（见 sshd-config-2026-06-16.md）
• 出网走代理：HTTP(S)_PROXY=http://127.0.0.1:8118。访问本机/内网用 curl --noproxy '*'
• 证书：Let's Encrypt（certbot），webroot 方式；续期 reload hook 为全局 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh（systemctl reload nginx）

托管的站点

1. vi.starbugs.net（Django 应用）

• 反代：nginx 443 → 127.0.0.1:8000（gunicorn）
• 站点配置：/etc/nginx/conf.d/vi.starbugs.net.conf
• 静态文件：/var/www/vi.starbugs.net/staticfiles/（location /static/）
• 全球解析到源站，证书 webroot 续期正常
• 部署详情见 nginx-vi.starbugs.net.md

2. Markdown 文档站（本目录 /var/local/docs）

• 服务：/opt/markdown-blog/app.py，Python stdlib HTTP server，监听 127.0.0.1:8010
• systemd 单元：blog-md.service（DynamicUser、ProtectSystem=strict、开机自启）
• 依赖：apt 包 python3-markdown / python3-pygments / python3-pymdownx（不用 pip，内网镜像经代理不可达）
• 渲染：GFM + 代码高亮（codehilite）+ 数学公式（pymdownx.arithmatex + MathJax CDN）
• 路由：GET / 目录索引；GET /d/<name>.md 渲染单篇；含路径穿越防护
• 子路径前缀：读取 X-Forwarded-Prefix 头生成链接（挂子路径时由 nginx 下发）
• 当前对外入口：https://vi.starbugs.net/blog/（blog.starbugs.net 证书未就绪的临时方案）
• 部署详情、待办、blog.starbugs.net 计划见 nginx-blog.starbugs.net.md

关键约定 / 易踩的坑

• HTTP/3 reuseport：每个 address:port 全机只能设一次，已被 vi.starbugs.net.conf 的 listen 443 quic reuseport 占用。新增 443 quic server 时 必须写 listen 443 quic;（不带 reuseport），否则 nginx -t 报 duplicate。
• 改 nginx 后务必 nginx -t && systemctl reload nginx。
• 文档热更新：往 /var/local/docs/*.md 放文件即生效，无需重启 blog-md。
• 本机 HTTPS 自测用 --resolve <域名>:443:127.0.0.1 + --noproxy '*'。
• blog.starbugs.net DNS 坑：DNSPod 地域智能解析把境外线路指向 TencentEdgeOne CDN （返回 webblock 页），导致 Let's Encrypt HTTP-01 验证失败；解决方案是把境外线路改回源站。
• 防火墙/安全组需放行 TCP80 / TCP443 / UDP443（HTTP/3）。

常用命令

# Markdown 服务
systemctl status blog-md --no-pager
journalctl -u blog-md -n 50 --no-pager
systemctl restart blog-md
curl -s --noproxy '*' http://127.0.0.1:8010/

# nginx
nginx -t && systemctl reload nginx
curl --noproxy '*' -I --http2 --resolve vi.starbugs.net:443:127.0.0.1 https://vi.starbugs.net/blog/

# 证书
certbot certificates
certbot renew --dry-run

本目录文档索引

• nginx-vi.starbugs.net.md —— vi.starbugs.net（Django）HTTP/2+3 部署记录
• nginx-blog.starbugs.net.md —— Markdown 文档站部署记录 + blog 域名待办
• sshd-config-2026-06-16.md —— SSH 端口/密码登录加固记录
• dcf-valuation.md / discount-rate.md —— 投资笔记（含数学公式，用于验证渲染）