blog/write-server

Write Server

Hugo 博客的本地管理后台，基于 Next.js 16 + Tailwind CSS 4，Docker 容器化部署。

域名：https://post.usj.cc

功能模块

模块	路径	说明
文章管理	/	列表、搜索、编辑、删除、预览
撰写文章	/edit	Markdown 编辑器，图片上传
评论管理	/comments	Artalk 评论回复、删除
订阅源	/feeds	RSS 订阅源管理
友链管理	/links	友链增删改查
图片管理	/images	图片上传管理
公众号	/wechat	微信公众号发布（自包含）
回收站	/recycle	已删文章恢复
Bot 管理	/bot	Telegram Bot / Hugo 状态

技术栈

• 框架: Next.js 16 (Turbopack, standalone 输出)
• 样式: Tailwind CSS 4, SEN 暖色系
• 数据: 直接读写 Hugo Markdown 文件，无数据库
• 评论: Artalk API v2
• Bot: Telegram Bot (长轮询)
• 公众号: 微信 API 直连（不依赖外部服务）
• 反向代理: Nginx + Basic Auth + Service Worker
• Hugo 预览: 独立端口 1313，HTTPS 访问

目录结构

write-server/
├── src/                        # 源代码
│   ├── app/                    # Next.js 页面和 API
│   ├── components/             # React 组件
│   └── lib/                    # 核心库（posts, recycle, bot, wechat, hugo）
├── nginx/                      # Nginx 配置
│   ├── conf.d/                 # 站点配置（主站 + Hugo 预览）
│   ├── login.html              # 登录页面
│   └── sw.js                   # Service Worker（认证）
├── entrypoint.sh               # Docker 入口脚本（权限修复）
├── Dockerfile                  # Docker 镜像
├── docker-compose.yml          # Docker Compose
├── .env.example                # 环境变量模板
└── .htpasswd                   # Basic Auth 密码文件

端口说明

端口	用途	协议
80	HTTP → HTTPS 重定向	HTTP
443	写作后台（nginx 代理 → 8016）	HTTPS
1313	Hugo 预览（nginx 代理 → 容器内 1313）	HTTPS
8016	write-server（仅容器内部）	-

环境变量 (.env)

# 评论系统
ARTALK_SERVER=https://artalk.usj.cc
ARTALK_SITE=优世界

# Telegram Bot
TG_BOT_TOKEN=your-bot-token
TG_ALLOWED_CHAT_IDS=your-chat-id

# 微信公众号（自包含，直连微信 API）
WECHAT_APP_ID=your-app-id
WECHAT_APP_SECRET=your-app-secret

# RSS/友链 API
RSS_API_BASE=https://api.usj.cc
RSS_API_TOKEN=your-token

# AI
DEEPSEEK_API_KEY=your-key
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL=deepseek-chat

# 其他
DEFAULT_AUTHOR=小赵
PREFER_IFACE=eth0

常用命令

# 启动
docker compose up -d

# 停止
docker compose down

# 重建（代码/Dockerfile 变更后）
docker compose down
docker compose build --no-cache
docker compose up -d

# 查看日志
docker logs write-server -f
docker logs write-nginx -f

# 重启单个服务
docker compose restart write-server
docker compose restart nginx

---

迁移到新服务器

1. 新服务器准备

# 安装 Docker
curl -fsSL https://get.docker.com | sh
systemctl enable docker
systemctl start docker

# 安装 docker compose 插件
apt install -y docker-compose-plugin git

2. 克隆项目

cd ~
mkdir -p hugo && cd hugo
git clone <your-repo-url> blog
cd blog/write-server

3. 配置环境变量

cp .env.example .env
nano .env

填写所有必要的 Token 和 API Key。

4. 生成 Basic Auth 密码

docker run --rm httpd:alpine htpasswd -nbB admin "your-password" > .htpasswd

5. 配置域名 DNS

添加 A 记录指向新服务器 IP：

post.usj.cc  →  新服务器IP

6. 申请 SSL 证书

apt install -y certbot

# 先启动 nginx（HTTP 模式）
docker compose up -d nginx

# 停 nginx 释放 80 端口
docker compose stop nginx

# 申请证书
certbot certonly --standalone -d post.usj.cc --agree-tos --email your@email.com

# 复制证书
mkdir -p nginx/ssl
cp /etc/letsencrypt/live/post.usj.cc/fullchain.pem nginx/ssl/
cp /etc/letsencrypt/live/post.usj.cc/privkey.pem nginx/ssl/

# 启动所有服务
docker compose up -d

7. 配置防火墙

ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 1313/tcp
ufw enable

8. 配置 Git

# 博客目录需要 git 可写
git config --global --add safe.directory /root/hugo/blog

9. 验证

# 检查容器状态
docker ps

# 检查 API
curl -s https://post.usj.cc/api/stats

# 检查 Hugo 预览
curl -s https://post.usj.cc:1313/ | head -5

10. 自动续期 SSL 证书

# 添加 crontab
crontab -e

# 添加：
0 3 1 * * certbot renew --quiet && docker compose restart nginx

---

迁移清单

换服务器时需要迁移的内容：

必须迁移

内容	位置	说明
博客源码	~/hugo/blog/	git clone 即可
write-server 代码	~/hugo/blog/write-server/	git clone 即可
.env 文件	write-server/.env	手动创建，填写 Token
.htpasswd 文件	write-server/.htpasswd	重新生成
SSL 证书	nginx/ssl/	重新申请

可选迁移

内容	位置	说明
回收站数据	write-server/recycle/	30 天自动过期，可不迁移
日志	write-server/logs/	可不迁移

需要在新服务器操作

操作	说明
DNS 解析	把 post.usj.cc 指向新 IP
SSL 证书	在新服务器重新申请
防火墙	放行 80, 443, 1313 端口
git safe.directory	新服务器执行 git config --global --add safe.directory ...
微信 IP 白名单	如果用公众号功能，新服务器 IP 需加入微信白名单

不需要迁移

内容	原因
Docker 镜像	新服务器重新构建
node_modules	Docker 构建时自动安装
.next 目录	Docker 构建时自动生成
Hugo 二进制	Dockerfile 自动安装

---

已知限制

• Hugo 预览和写作后台共用域名，Hugo 导航链接只在 1313 端口有效
• Telegram Bot 通过 Docker 挂载的 SSH 密钥进行 git push
• 博客目录 owner 会被 entrypoint 改为 uid 1001（nextjs 用户）
• 3 小时登录过期（localStorage + Service Worker 双重检查）

License

MIT