宝塔面板部署OneBlog：Java博客系统完整搭建与反向代理配置指南

1. 为什么选择在宝塔面板上部署OneBlog

1.1 从一个真实需求说起

手里有台闲置的云主机，想搭个干净、可控、不依赖第三方平台的个人博客，这个念头估计很多做运维或者开发的朋友都动过。市面上的选择无非几类：要么是托管型博客服务，注册即用但数据不在自己手里；要么是静态站点生成器，写起来爽但评论、搜索、后台管理都得自己拼；再要么就是自建动态博客系统，功能全、可控性强，但部署和维护有一定门槛。

OneBlog 属于第三类里比较讨巧的一个。它是一套基于 Java 开发的开源博客系统，后端用 Spring Boot，前端是前后端分离的架构，自带管理后台、文章管理、分类标签、评论、友链、站点统计这些博客该有的东西。相比一些老牌的 PHP 博客系统，它的技术栈更现代，界面也更清爽；相比纯静态方案，它又省去了自己折腾评论系统和搜索的麻烦。

那为什么要把宝塔面板拉进来？因为对大多数人来说，在一台裸机上从零装 JDK、装数据库、配反向代理、配 SSL、设开机自启，这一套流程走下来，光是环境问题就能劝退一半人。宝塔面板的价值就在于把这些重复劳动图形化了——软件商店点几下装好运行环境，网站菜单里点几下配好反向代理和证书，剩下的精力可以全部放在博客本身。这不是偷懒，而是把时间花在更值得的地方。

这篇文章适合三类人看：一是手里有服务器、想搭个人博客但不想深陷运维细节的开发者；二是已经用过宝塔、想找个靠谱开源博客系统练手的运维新手；三是单纯想了解一套 Java 博客系统完整部署链路的同学。下面我会把整个部署过程拆开讲透，包括每一步为什么这么做、参数怎么定、坑在哪里。

1.2 部署方案的整体思路

在动手之前，先把整体架构理清楚，后面每一步操作你才知道自己在干什么。

OneBlog 的运行需要三样东西：JDK 运行环境（它编译出来是 jar 包，靠 Java 跑）、MySQL 数据库（存文章、用户、配置这些数据）、反向代理（对外用 80/443 端口，把请求转发给内部真正跑博客的那个端口）。宝塔面板在这里扮演的是"总控台"的角色，JDK 和 MySQL 通过它的软件商店安装，反向代理通过它的网站功能配置，SSL 证书通过它的一键申请搞定。

整个数据流向是这样的：用户浏览器访问你的域名，请求先到 Nginx（宝塔默认装的 Web 服务器），Nginx 根据你配的反向代理规则，把请求转发到本机某个端口（比如 8080），这个端口上跑的就是 OneBlog 的 Java 进程，进程再去 MySQL 里读写数据，然后把结果原路返回给用户。

理解了这个链路，你就会明白为什么不能直接把博客端口暴露出去——一是难看（域名后面要带端口号），二是没法方便地配 HTTPS，三是安全性差。反向代理就是那道既美观又安全的门面。

提示：部署前先确认你的服务器配置。OneBlog 是 Java 应用，内存占用比 PHP 博客高一些，建议至少 2 核 2G 起步，1G 内存的机器跑起来会比较吃力，容易在启动阶段就被系统 OOM 杀掉。

2. 部署前的环境准备与关键决策

2.1 服务器与系统的基础选择

服务器这块，主流云厂商的入门款就够用，重点是系统版本。我个人的习惯是选较新的稳定版 Linux 发行版，比如常见的 64 位服务器系统。为什么不选太老的版本？因为宝塔面板和它软件商店里的 JDK、MySQL 对新系统支持更好，老系统上偶尔会遇到依赖库版本对不上的问题，排查起来很烦。

系统装好后第一件事是更新软件源并升级已有包，这一步能避免很多"莫名其妙装不上"的问题。用宝塔官方提供的一键安装脚本装面板，装完后通过面板地址登录，绑定好账号。这里有个细节：宝塔安装完成后会输出面板地址、用户名和密码，务必第一时间保存，并且登录后立刻改掉默认密码、开启面板 SSL，别嫌麻烦。

关于安全组和防火墙，需要放行的端口有：宝塔面板端口（自己设的那个）、SSH 端口、80 和 443。数据库端口 3306 和博客应用端口 8080不要对公网开放，它们只需要本机内部访问，开放出去纯属给自己找风险。

2.2 用宝塔软件商店装齐运行环境

登录宝塔后进"软件商店"，我们要装的核心软件有三个。

第一个是MySQL。版本选择上，OneBlog 对 MySQL 5.7 和 8.0 都支持，我建议直接上 8.0，字符集默认 utf8mb4，对 emoji 和特殊字符支持更好。安装方式选"极速安装"即可，编译安装太慢没必要。装完后记得在数据库菜单里改一下 root 密码，并且不要开启"允许 root 远程访问"，博客和数据库在同一台机器上，走本地 socket 就行。

第二个是JDK。OneBlog 通常要求 JDK 8 或 JDK 11，具体看它发布版本的说明。宝塔的软件商店里一般能直接搜到对应版本，装好后可以用命令行验证：

java -version

输出里能看到版本号就说明装好了。如果商店里没有你需要的版本，也可以手动下载对应版本的压缩包解压到某个目录，然后配置环境变量，但能用商店解决就别手动折腾。

第三个是Nginx。这个在装宝塔的时候通常已经自带了，如果没有就在商店里补装一个。Nginx 负责反向代理和 SSL 终止，是整个对外链路的入口。

注意：三个软件装完后，建议重启一次服务器，让所有服务以干净的状态启动。我遇到过装完 JDK 后环境变量没生效、导致后面启动脚本找不到 java 命令的情况，重启一次基本能规避。

2.3 数据库的初始化准备

环境装好后，先别急着传博客程序，把数据库准备好。在宝塔的"数据库"菜单里新建一个库，字符集选utf8mb4，排序规则选 utf8mb4_general_ci 或 utf8mb4_unicode_ci 都行。同时新建一个专用的数据库用户，给它只授予这个库的权限，不要图省事直接用 root。

为什么要单独建用户？因为博客程序里会明文写数据库账号密码，万一配置文件泄露，用专用低权限账号能把损失控制在一个库内，用 root 就是整台数据库沦陷。这是最基本的安全习惯。

建库的时候把库名、用户名、密码记下来，后面配置 OneBlog 的时候要一一对应填进去。库名建议用有辨识度的，比如带个 blog 前缀，避免和以后其他项目的库混淆。

3. OneBlog 的获取、配置与启动实操

3.1 获取程序包与目录规划

OneBlog 的源码和发布包一般在其开源仓库的 Release 页面提供。对大多数只想部署不想改代码的人来说，直接下载编译好的发布包最省事，通常是一个包含 jar 包和配置文件的压缩包。如果你要二次开发，那就克隆源码自己用 Maven 构建，但那是另一条路了。

下载方式有两种：一是在本地下载好再用宝塔的文件管理上传，二是直接在服务器上用命令行下载。服务器能直连的情况下，命令行更快：

cd /www/wwwroot mkdir oneblog cd oneblog # 假设发布包地址为示例地址，实际以官方发布为准 wget <发布包下载地址>

目录规划上，我习惯把博客程序放在/www/wwwroot/oneblog下，和宝塔的网站目录规范保持一致，方便统一管理。解压后你会看到类似application.yml或application-prod.yml这样的配置文件，以及一个可执行的 jar 包。

提示：解压后先ls -l看一眼文件权限，确保 jar 包有可读权限，配置文件没有被意外设成只读。权限问题导致的启动失败非常隐蔽，提前看一眼能省不少事。

3.2 核心配置文件的逐项修改

配置文件是整个部署里最需要细心的地方，改错一个字符都可能导致启动失败。用宝塔的文件管理器直接编辑，或者用命令行编辑器打开，重点改这几块。

数据库连接部分，把地址、库名、用户名、密码换成你前面建好的：

spring: datasource: url: jdbc:mysql://127.0.0.1:3306/你的库名?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: 你的数据库用户名 password: 你的数据库密码

这里有几个参数值得解释。useSSL=false是因为本机连接不需要 SSL，开着反而可能因为证书问题连不上；serverTimezone=Asia/Shanghai是必须的，MySQL 8.0 对时区很敏感，不指定时区经常报时区错误导致连接失败；characterEncoding=utf8配合库的 utf8mb4 字符集，保证中文和特殊字符不乱码。

服务端口部分，确认应用监听的端口，默认常见的是 8080：

server: port: 8080

这个端口只要不和服务器上其他服务冲突就行，它只在内部使用，不对外暴露。

文件上传路径部分，如果配置里有上传目录的设置，把它指向一个明确的、有写权限的目录，比如/www/wwwroot/oneblog/upload。这个目录要提前建好，否则上传图片时会报错。

改完配置后，强烈建议用命令检查一遍有没有语法错误，YAML 对缩进极其敏感，多一个空格少一个空格都会解析失败。

3.3 启动应用与验证运行状态

配置改好后就可以启动应用了。最直接的方式是前台启动，方便看日志：

cd /www/wwwroot/oneblog java -jar oneblog.jar --spring.profiles.active=prod

--spring.profiles.active=prod是告诉程序加载生产环境的配置文件，具体参数名以你下载的版本为准。前台启动能看到完整的启动日志，如果数据库连不上、端口被占用、配置有误，日志里都会明确报出来，这是排查问题最有效的方式。

看到类似 "Started Application in xx seconds" 的日志，就说明启动成功了。这时候别急着关终端，先在服务器本地验证一下：

curl http://127.0.0.1:8080

如果能返回 HTML 内容，说明应用本身没问题。确认无误后，按 Ctrl+C 停掉前台进程，改用后台方式运行，避免关掉 SSH 连接后程序就挂了。

后台运行我推荐用nohup配合日志重定向：

nohup java -jar oneblog.jar --spring.profiles.active=prod > /www/wwwroot/oneblog/app.log 2>&1 &

这样程序在后台跑，所有输出都写进 app.log，出问题随时能翻日志。更规范的做法是配一个 systemd 服务，实现开机自启和进程守护，但对新手来说 nohup 已经够用，先跑起来再说。

注意：用 nohup 启动后，记得ps -ef | grep java确认进程真的在跑，别以为敲完命令就万事大吉。我见过因为 jar 包路径写错、命令瞬间就退出、但终端没报错的情况。

4. 反向代理、域名与 HTTPS 的完整配置

4.1 在宝塔中新建站点并配置反向代理

应用在 8080 端口跑起来后，用户还是没法通过域名访问，因为 80 端口上还没有任何东西在监听。这一步用宝塔的"网站"功能来解决。

在"网站"菜单里点"添加站点"，域名填你准备好的域名，根目录随便指一个（反向代理场景下这个目录基本用不上），PHP 版本选"纯静态"。站点建好后，点进站点设置，找到"反向代理"选项卡，新建一个反向代理，目标 URL 填http://127.0.0.1:8080，发送域名填$host。

这里解释一下$host是什么意思。它表示把用户请求里的原始 Host 头透传给后端应用，这样后端才能知道用户访问的是哪个域名，对于多域名或者需要根据域名做逻辑的场景很重要。不填的话，后端收到的 Host 可能是 127.0.0.1，某些功能会异常。

代理配好后，理论上用域名访问就能看到博客首页了。如果打不开，先检查反向代理是否真的生效，再看应用日志有没有收到请求，逐段排查。

4.2 申请并部署 SSL 证书

现在没有 HTTPS 的站点基本没法看，浏览器会各种提示不安全。宝塔的 SSL 功能可以一键申请免费证书，非常方便。在站点设置的"SSL"选项卡里，选择 Let's Encrypt 或宝塔自家的免费证书，勾选域名，点申请。

申请成功后，记得打开"强制 HTTPS"开关，这样所有 HTTP 请求都会自动跳转到 HTTPS。这一步很关键，否则用户还是可能通过 HTTP 访问到不安全的版本。

证书是有有效期的，免费证书一般 90 天。宝塔支持自动续签，在 SSL 设置里把"自动续签"打开，省得三个月后忘了续导致站点报证书过期。我踩过的坑就是没开自动续签，某天访问突然一片红，排查半天才想起来是证书过期。

提示：如果申请证书时报域名验证失败，先确认域名解析是否已经生效、80 端口是否放行。证书申请需要外部能访问到你的服务器做验证，解析没生效或者端口没开都会失败。

4.3 验证整条链路是否通畅

配置全部完成后，做一次完整的验证。用浏览器访问https://你的域名，应该能看到 OneBlog 的首页。然后访问后台管理地址（通常是/admin之类的路径，具体看版本说明），用初始账号登录，试着发一篇文章、传一张图片、提交一条评论。

图片上传这块要特别验证，因为前面配的上传目录如果权限不对，这里就会失败。如果上传报错，去应用日志里找具体原因，多半是目录不存在或者没有写权限，用chmod给目录加上写权限即可。

再验证一下 HTTPS 是否强制生效：手动输入http://你的域名，看是否自动跳到了 https。如果没跳，回站点设置里检查强制 HTTPS 开关。

5. 常见问题排查与长期维护经验

5.1 启动阶段的高频故障速查

部署过程中最容易出问题的就是启动阶段，我把常见的几类整理成表，方便对照排查。

502 错误是反向代理场景下最常见的，本质就是 Nginx 转发请求给后端时，后端没响应。要么是应用没跑起来，要么是代理地址写错了。排查顺序永远是：先本地 curl 应用端口，确认应用活着，再去查代理配置。

5.2 运行阶段的稳定性维护

博客跑起来只是开始，长期稳定运行需要一些维护习惯。

日志管理。nohup 输出的 app.log 会一直增长，时间长了能把磁盘占满。建议配一个日志切割，或者定期手动清理。宝塔的"计划任务"里可以设置定时清理日志文件，很省心。

数据库备份。文章数据是博客最宝贵的资产，一定要定期备份。宝塔的数据库菜单支持一键备份，也可以在计划任务里设置每天自动备份并保留最近 N 份。备份文件最好再同步到别的地方，别和数据库放同一台机器，否则机器一挂全没了。

进程守护。nohup 启动的进程如果因为内存溢出之类的原因挂掉，是不会自动重启的。对稳定性要求高的，建议配 systemd 服务，设置Restart=always，进程挂了自动拉起来。这是从"能跑"到"跑得稳"的关键一步。

资源监控。Java 应用吃内存，要留意服务器的内存使用情况。宝塔的监控面板能看到 CPU、内存、磁盘的实时曲线，发现内存持续走高就要警惕，可能是内存泄漏或者配置的堆内存太小。

5.3 几个我踩过的坑和独家心得

第一个坑是字符集。一开始建库时随手选了默认字符集，结果发带 emoji 的文章直接报错。后来把库、表、连接三处的字符集统一成 utf8mb4 才解决。所以建库那一步千万别偷懒，字符集选对能省掉后面一堆乱码和报错。

第二个坑是时区。MySQL 8.0 默认时区和 Java 应用对不上，导致文章发布时间差了 8 小时。加上serverTimezone=Asia/Shanghai后正常。这个问题很隐蔽，因为不影响功能，只是时间不对，容易很久才发现。

第三个心得是先前台启动再后台运行。很多人一上来就用 nohup 后台跑，结果启动失败啥日志都看不到，干着急。正确的姿势是先前台跑一次，确认日志干净、启动成功，再切后台。这个习惯能帮你快速定位 90% 的启动问题。

第四个心得是配置改动后一定要重启应用。配置文件不是热加载的，改完不重启等于没改。我见过改了半天配置发现没生效，最后发现是忘了重启的。养成"改配置必重启、重启必看日志"的习惯。

最后一个建议是分阶段验证。不要一口气把所有东西配完再测试，那样出问题很难定位是哪一步的错。正确的节奏是：装完环境验证环境、建完库验证连接、启动应用验证本地访问、配完代理验证域名访问、配完证书验证 HTTPS。每一步都确认无误再进下一步，出问题时范围就锁定在最近这一步，排查效率高得多。

这套流程走下来，一台干净的服务器到能正常访问的 OneBlog 博客，顺利的话一两个小时能搞定。真正花时间的往往不是操作本身，而是遇到问题时的排查。把上面这些原理和坑点理解了，下次再部署类似的 Java 应用，你会发现套路都是相通的——环境、配置、启动、代理、证书，五步走完，剩下的就是内容创作的事了。