added:增加Linux-server
This commit is contained in:
1 parent
6fe4e9d23f
commit
d78f3f811b
90 files changed
+16784
-1
No files matched your search
@@ -0,0 +1,202 @@
|
||||
# Write Server - Hugo Blog Admin for Linux
|
||||
# 基于 Next.js 16 的 Hugo 博客管理后台 Linux 部署版本
|
||||
|
||||
这是一个为 Linux 服务器优化的 Hugo 博客管理后台,支持 Docker 部署和 systemd 服务管理。
|
||||
|
||||
## 特性
|
||||
|
||||
- 完整的博客管理功能(文章、评论、友链、订阅源等)
|
||||
- Docker 容器化部署
|
||||
- systemd 服务支持
|
||||
- Nginx 反向代理配置
|
||||
- 自动重启和健康检查
|
||||
- 日志管理
|
||||
- 备份策略
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 方式一:Docker 部署(推荐)
|
||||
|
||||
```bash
|
||||
# 1. 克隆项目
|
||||
git clone <your-repo-url>
|
||||
cd write-server
|
||||
|
||||
# 2. 配置环境变量
|
||||
cp .env.example .env
|
||||
nano .env # 编辑配置
|
||||
|
||||
# 3. 启动服务
|
||||
docker-compose up -d
|
||||
|
||||
# 4. 查看日志
|
||||
docker-compose logs -f
|
||||
```
|
||||
|
||||
### 方式二:直接部署
|
||||
|
||||
```bash
|
||||
# 1. 安装依赖
|
||||
./scripts/install.sh
|
||||
|
||||
# 2. 配置环境变量
|
||||
cp .env.example .env
|
||||
nano .env
|
||||
|
||||
# 3. 启动服务
|
||||
./scripts/start.sh
|
||||
|
||||
# 4. 设置开机自启
|
||||
sudo ./scripts/setup-service.sh
|
||||
```
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
write-server/
|
||||
├── src/ # 源代码
|
||||
├── public/ # 静态资源
|
||||
├── scripts/ # 部署脚本
|
||||
├── nginx/ # Nginx 配置
|
||||
├── systemd/ # systemd 服务文件
|
||||
├── backups/ # 备份目录
|
||||
├── logs/ # 日志目录
|
||||
├── Dockerfile # Docker 镜像配置
|
||||
├── docker-compose.yml # Docker Compose 配置
|
||||
├── .env.example # 环境变量模板
|
||||
└── README.md # 本文档
|
||||
```
|
||||
|
||||
## 配置说明
|
||||
|
||||
### 环境变量
|
||||
|
||||
复制 `.env.example` 为 `.env`,并填写以下配置:
|
||||
|
||||
```bash
|
||||
# 博客根目录(Hugo 项目路径)
|
||||
BLOG_ROOT=/path/to/your/hugo/blog
|
||||
|
||||
# 服务端口
|
||||
PORT=8016
|
||||
|
||||
# Artalk 评论系统
|
||||
ARTALK_SERVER=https://artalk.your-domain.com
|
||||
ARTALK_SITE=Your Site Name
|
||||
|
||||
# Telegram Bot(可选)
|
||||
TG_BOT_TOKEN=your-bot-token
|
||||
TG_ALLOWED_CHAT_IDS=your-chat-id
|
||||
|
||||
# 微信公众号(可选)
|
||||
WECHAT_APP_ID=your-app-id
|
||||
WECHAT_APP_SECRET=your-app-secret
|
||||
|
||||
# AI 配置(可选)
|
||||
DEEPSEEK_API_KEY=your-api-key
|
||||
DEEPSEEK_BASE_URL=https://api.deepseek.com
|
||||
DEEPSEEK_MODEL=deepseek-chat
|
||||
```
|
||||
|
||||
### Nginx 配置
|
||||
|
||||
如果需要域名访问,参考 `nginx/write-server.conf` 配置 Nginx 反向代理。
|
||||
|
||||
## 管理命令
|
||||
|
||||
```bash
|
||||
# Docker 方式
|
||||
docker-compose up -d # 启动
|
||||
docker-compose down # 停止
|
||||
docker-compose restart # 重启
|
||||
docker-compose logs -f # 查看日志
|
||||
docker-compose ps # 查看状态
|
||||
|
||||
# systemd 方式
|
||||
sudo systemctl start write-server # 启动
|
||||
sudo systemctl stop write-server # 停止
|
||||
sudo systemctl restart write-server # 重启
|
||||
sudo systemctl status write-server # 查看状态
|
||||
sudo journalctl -u write-server -f # 查看日志
|
||||
```
|
||||
|
||||
## 备份与恢复
|
||||
|
||||
```bash
|
||||
# 手动备份
|
||||
./scripts/backup.sh
|
||||
|
||||
# 恢复备份
|
||||
./scripts/restore.sh backups/write-server-20260101.tar.gz
|
||||
|
||||
# 自动备份(已配置 cron)
|
||||
crontab -l # 查看定时任务
|
||||
```
|
||||
|
||||
## 更新升级
|
||||
|
||||
```bash
|
||||
# 拉取最新代码
|
||||
git pull
|
||||
|
||||
# Docker 方式
|
||||
docker-compose build --no-cache
|
||||
docker-compose up -d
|
||||
|
||||
# 直接部署方式
|
||||
npm install
|
||||
npm run build
|
||||
sudo systemctl restart write-server
|
||||
```
|
||||
|
||||
## 故障排查
|
||||
|
||||
### 查看日志
|
||||
|
||||
```bash
|
||||
# 应用日志
|
||||
tail -f logs/app.log
|
||||
|
||||
# PM2 日志(直接部署方式)
|
||||
pm2 logs write-server
|
||||
|
||||
# Docker 日志
|
||||
docker-compose logs -f
|
||||
```
|
||||
|
||||
### 常见问题
|
||||
|
||||
1. **端口被占用**
|
||||
```bash
|
||||
lsof -i :8016
|
||||
kill -9 <PID>
|
||||
```
|
||||
|
||||
2. **权限问题**
|
||||
```bash
|
||||
sudo chown -R $USER:$USER /path/to/blog
|
||||
```
|
||||
|
||||
3. **Hugo 未安装**
|
||||
```bash
|
||||
# 参考 scripts/install.sh 安装 Hugo
|
||||
```
|
||||
|
||||
## 安全建议
|
||||
|
||||
1. 使用 HTTPS(配置 SSL 证书)
|
||||
2. 限制访问 IP(防火墙或 Nginx 配置)
|
||||
3. 定期更新依赖
|
||||
4. 启用访问日志
|
||||
5. 配置 fail2ban 防暴力破解
|
||||
|
||||
## 性能优化
|
||||
|
||||
1. 启用 Gzip 压缩
|
||||
2. 配置 CDN
|
||||
3. 使用 PM2 集群模式
|
||||
4. 配置 Redis 缓存(可选)
|
||||
|
||||
## 许可证
|
||||
|
||||
MIT License
|
||||
Reference in new issue
Block a user