宝塔面板默认不支持solr，因其java环境管理仅适配tomcat且内置jdk阉割、solr 8.0+弃用war包改用jetty脚本启动，强依赖系统级java_home和完整jre 8+；常见问题包括java_home未设、solr.home识别失败、8983端口被拦截或反代缓存导致界面异常。
宝塔面板上直接装 Solr 不现实，必须绕过面板手动配 Java 环境和反向代理，否则会卡在 java 命令不可用、solr.home 无法识别、或 8983 端口被拦截这三处。
为什么宝塔默认不支持 Solr 运行
宝塔的「软件商店」里没有 Solr，它的 Java 环境管理只面向 Tomcat（且仅限于面板内置的 JDK 版本），而 Solr 从 8.0+ 起已弃用 WAR 包部署方式，改用自带 Jetty 的 bin/solr 启动脚本 —— 这个脚本强依赖系统级 JAVA_HOME 和完整 JRE 8+（不是宝塔面板里那个阉割版）。
常见错误现象：
- 执行
./solr start报错：ERROR: JAVA_HOME is not set或Unsupported Java version - 启动后访问
http://IP:8983/solr显示空白或 404，但netstat -tuln | grep 8983确实有监听 - 宝塔防火墙开着，但没放行 8983 端口；或者开启了「网站防篡改」导致反向代理失败
手动安装 OpenJDK 11 并验证可用性
别用宝塔自带的 JDK，它路径藏得深、版本旧、javac 缺失，bin/solr 脚本直接拒绝启动。必须用系统级安装：
- SSH 登录服务器，执行：
sudo apt update && sudo apt install -y openjdk-11-jre-headless（Ubuntu/Debian）或sudo yum install -y java-11-openjdk-headless（CentOS 7+/AlmaLinux） - 确认生效：
java -version输出应含11.，且which java返回/usr/bin/java而非宝塔目录 - 设置全局
JAVA_HOME：echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' | sudo tee -a /etc/profile && source /etc/profile（路径按ls /usr/lib/jvm实际输出调整）
解压 Solr 并配置 solr.home 与端口绑定
Solr 9.x 默认绑定 127.0.0.1:8983，宝塔反代必须让它监听外网 IP 或 0.0.0.0，否则 nginx 无法 upstream：
- 下载 Solr 9.5（当前最新稳定版）：
wget https://downloads.apache.org/lucene/solr/9.5.0/solr-9.5.0.tgz - 解压到非宝塔网站目录（如
/opt/solr）：tar xzf solr-9.5.0.tgz -C /opt/ && sudo chown -R www:www /opt/solr-9.5.0 - 创建独立
solr.home：mkdir -p /data/solr/home && cp -r /opt/solr-9.5.0/server/solr/* /data/solr/home/ - 启动时显式指定地址和 home：
/opt/solr-9.5.0/bin/solr start -a "-Dsolr.solr.home=/data/solr/home" -p 8983 -h 0.0.0.0
此时 curl http://localhost:8983/solr/#/~cores 应返回管理页 HTML；若超时，检查 ss -tuln | grep 8983 是否监听 *:8983。
用宝塔反向代理替代直接暴露 8983 端口
绝不能在安全组或宝塔防火墙里直接放行 8983 —— Solr 管理后台无认证，暴露即沦陷。必须走 HTTPS + 反向代理 + 访问控制：
- 在宝塔「网站」中新建一个纯静态站点（如
solr.example.com），不选 PHP/MySQL - 进入该站点「反向代理」，添加规则：
https://solr.example.com→http://127.0.0.1:8983 - 在「SSL」中申请并强制 HTTPS；在「防火墙」中关闭 8983 端口（只留 80/443）
- 关键一步：启用「访问限制」→ 添加 IP 白名单（如运维办公 IP），或设密码（Basic Auth）—— 宝塔「网站」→「设置」→「配置文件」末尾加：
auth_basic "Solr Admin"; auth_basic_user_file /www/wwwroot/solr.example.com/.htpasswd;
然后用htpasswd -c /www/wwwroot/solr.example.com/.htpasswd admin创建账号
完成之后，只能通过 https://solr.example.com/#/~cores 访问，且受 HTTPS 加密和访问控制双重保护。任何直接连 :8983 的请求都会被系统防火墙丢弃。
最容易被忽略的是 -h 0.0.0.0 启动参数和反向代理里没关掉「缓存」—— Solr 的管理界面含大量动态 JS/CSS，宝塔默认开启的 proxy_cache 会导致页面错乱或按钮失效，务必在反向代理配置中禁用缓存。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
