项目地址：
- 后端：LiuYuYang01/ThriveX-Server
- 控制台：LiuYuYang01/ThriveX-Admin
- 前端：LiuYuYang01/ThriveX-Blog
开源协议：AGPL-3.0（请保留版权）
如果你正在寻找一个现代化、功能完整、界面美观的开源博客系统，ThriveX 绝对值得尝试。它基于 Spring Boot + Vue3 + Next.js 构建，支持文章管理、评论、用户权限、图片上传等核心功能，并且部署简单。
本文将带你从零开始，使用国产面板 1Panel 在云服务器上完整部署 ThriveX 全套服务（后端 API + 管理后台 + 博客前端），全程无需复杂命令，适合新手！
✅ 一、准备工作
1. 服务器要求
- 系统：Ubuntu 20.04 / 22.04（推荐）
- 配置：2核4G 起（内存不足可能导致构建失败）
- 网络：开放安全组端口
80、443、11803（1Panel 默认端口）
2. 域名准备（3个子域名）
| 用途 | 示例 |
|---|---|
| 后端 API | api.yourdomain.com |
| 管理后台 | admin.yourdomain.com |
| 博客前端 | yourdomain.com |
💡 提前将这三个域名解析到你的服务器 IP。
3. 安装 1Panel（若未安装）
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh
安装完成后，浏览器访问：http://你的IP:11803/安全入口（如 http://1.2.3.4:11803/daab25c3fa）
✅ 二、部署顺序说明
⚠️ 必须严格按顺序操作：
后端 → 控制台 → 前端
90% 的问题都源于后端未部署成功！
✅ 三、第一步：部署后端（ThriveX-Server）
1. 创建数据库
- 进入 1Panel → 数据库
- 点击 创建数据库
- 名称：
thrivex - 用户名：
thrivex - 密码：
d3BawEx2eGDrHYTiwa（可自定义，但需记住） - 字符集：
utf8mb4
- 名称：
2. 导入初始化 SQL
- 下载 SQL 文件：ThriveX.sql
- 在数据库列表中找到
thrivex，点击 导入备份，上传并执行该文件
3. 上传 Jar 包
- 下载最新
blog.jar：Releases - 在 1Panel → 文件 中创建目录
/www/thrivex_server - 上传
blog.jar到该目录
4. 创建 Java 运行环境
- 进入 网站 → 运行环境 → 创建
- 填写配置：
- 名称：
thrivex-server - 应用：
Java - 版本：OpenJDK 1.8（⚠️ 必须选 1.8！）
- 源码目录：
/www/thrivex_server - 启动命令：
java -jar blog.jar \ --PORT=9003 \ --spring.datasource.url=jdbc:mysql://localhost:3306/thrivex?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true \ --spring.datasource.username=thrivex \ --spring.datasource.password=d3BawExGDrHYTiwa - 端口：
9003
- 名称：
- 点击 创建
5. 绑定域名 & 验证
- 绑定域名：
api.yourdomain.com - 访问
https://api.yourdomain.com/doc.html - 测试登录接口：
{ "username": "admin", "password": "123456" }若返回
code: 200，后端部署成功 ✅
✅ 四、第二步：部署控制台（ThriveX-Admin）
本地操作（Windows / macOS / Linux 均可）
1. 安装 Node.js（≥ v20）
- 官网下载：https://nodejs.org/
- 安装后验证：
node -v应 ≥20.x
2. 下载并构建项目
# 下载源码（或直接下载 ZIP）
git clone https://github.com/LiuYuYang01/ThriveX-Admin.git
cd ThriveX-Admin
# 安装依赖（解决依赖冲突）
npm install --legacy-peer-deps
# 配置 API 地址
echo "VITE_API_BASE_URL=https://api.yourdomain.com" > .env
# 构建
npm run build
✅ 成功后生成
dist目录
3. 上传到服务器
- 在 1Panel → 文件 中创建
/www/thrivex_admin - 将本地
dist打包为zip，上传并解压到该目录
4. 创建网站
- 网站 → 创建网站
- 域名：
admin.yourdomain.com - 根目录：
/www/thrivex_admin - PHP 版本：纯静态
- 域名：
- 编辑 Nginx 配置，添加：
location / { try_files $uri $uri/ /index.html; }
5. 验证
访问 https://admin.yourdomain.com，使用 admin / 123456 登录 ✅
✅ 五、第三步：部署前端（ThriveX-Blog）
流程与控制台类似：
1. 本地构建
git clone https://github.com/LiuYuYang01/ThriveX-Blog.git
cd ThriveX-Blog
npm install --legacy-peer-deps
# 修改 next.config.mjs，添加你的域名到 images.domains
# 例如：domains: ['yourdomain.com', 'api.yourdomain.com']
npm run build
2. 上传并部署
- 创建目录
/www/thrivex_blog - 上传整个项目（含
.next,public,package.json） - 创建 Node.js 运行环境：
- 版本：
20.x - 启动命令：
npx next start -p 3000 - 端口：
3000
- 版本：
- 绑定域名：
yourdomain.com
3. 验证
访问 https://yourdomain.com，应看到博客首页 ✅
✅ 六、常见问题解答
❓ Q1：为什么后端启动报 UnknownHostException？
A：
DB_INFO不能写成mysql:3306/thrivex，必须用完整 JDBC URL，或直接使用spring.datasource.url。
❓ Q2：Windows 上 npm install 报错？
A：使用 CMD 而非 PowerShell，或运行
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。
❓ Q3：如何更新 ThriveX？
A：关注 GitHub Releases，手动替换 jar 或重新构建前端，务必先备份数据库！
❓ Q4：能删除版权吗？
A：项目 Star 达 2K 后可自由选择是否保留。目前请遵守 AGPL-3.0 协议，保留版权。
🎉 七、结语
至此，你已成功部署了一套完整的 ThriveX 博客系统！🎉
无论是写作、分享还是技术博客，它都能满足你的需求。
最后提醒：
- 请保留页面底部的 “Powered by ThriveX” 版权信息
- 如遇问题，可加作者微信
liuyuyang2023（备注：技术支持）- 项目发展离不开你的 Star ⭐：ThriveX-Server
弘扬开源精神，从你我做起！
