宝塔面板Nginx+Zookeeper配置全攻略，从环境搭建到高可用架构

配置宝塔面板的Nginx和Zookeeper涉及多个步骤,以下是一个基本的指南，帮助你完成这些配置。

安装Nginx

登录宝塔面板：
- 打开浏览器,输入宝塔面板的IP地址和端口号（默认是8888）。
- 输入用户名和密码登录。
安装Nginx：
- 在宝塔面板中,点击左侧菜单栏的“软件商店”。
- 搜索“Nginx”，找到并点击“安装”按钮。
- 等待安装完成,稍等片刻。
启动Nginx：
- 点击左侧菜单栏的“服务”。
- 找到“Nginx”，右键点击并选择“启动”。

配置Nginx

编辑站点配置：
- 在宝塔面板中,点击左侧菜单栏的“网站”。
- 找到你想要配置的站点,点击进入编辑模式。
- 在站点配置页面,找到“配置文件”部分。
添加Nginx配置：

复制原有的Nginx配置内容,并添加或修改以下内容：

server {
    listen 80;
    server_name your_domain.com;
    root /path/to/your/site;
    index index.html index.htm;
    location / {
        try_files $uri $uri/ =404;
    }
    location ~ .*\.(php|jsp|asp|htm|css|js)$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

将 your_domain.com 替换为你的域名。
将 /path/to/your/site 替换为你的站点路径。

保存配置：
修改完毕后,点击右上角的“保存”按钮。

安装Zookeeper

下载Zookeeper：
- 在宝塔面板中,点击左侧菜单栏的“软件商店”。
- 搜索“Zookeeper”，找到并点击“下载”按钮。
- 下载完成后,解压文件到你希望的安装目录。
配置Zookeeper：
- 进入Zookeeper的安装目录,编辑 conf/zoo.cfg 文件。
- 添加或修改以下内容：

dataDir=/path/to/zookeeper/data
clientPort=2181
initLimit=5
syncLimit=2
server.1=your_server_ip:2888:3888
server.2=your_server_ip:2888:3888
server.3=your_server_ip:2888:3888

将 your_server_ip 替换为你的服务器IP地址。
将 /path/to/zookeeper/data 替换为你希望的数据存储路径。

启动Zookeeper：
进入Zookeeper的安装目录,执行以下命令启动Zookeeper：

bin/zkServer.sh start

验证配置

验证Nginx：

打开浏览器,输入你的域名，确保Nginx能够正确加载你的站点。
验证Zookeeper：

打开Zookeeper客户端,使用以下命令连接：

./bin/zkCli.sh -server your_server_ip:2181

输入 ls / 命令，查看Zookeeper中的节点列表，确保节点已正确创建。

通过以上步骤,你应该能够成功配置宝塔面板的Nginx和Zookeeper，如果遇到任何问题，请检查日志文件以获取更多信息。

在分布式系统与微服务架构盛行的今天,Zookeeper作为一款经典的分布式协调服务组件，承担着服务注册与发现、配置管理、分布式锁等核心职责，而对于大多数运维人员和开发者来说，宝塔面板凭借其直观的图形化界面和丰富的功能，大大降低了服务器管理的门槛。

本文将详细讲解如何在已安装宝塔面板的Linux服务器上,结合Nginx反向代理实现Zookeeper的安全访问，并完成从基础环境部署到生产环境优化的完整配置流程。

环境准备

1 基础环境

操作系统：CentOS 7.9 / Ubuntu 22.04（本文以CentOS为例）
宝塔面板：最新稳定版（已安装）
Nginx：通过宝塔面板软件商店安装，版本≥1.20
Zookeeper：可选版本3.8.x或3.9.x（推荐官方稳定版）

2 防火墙与端口规划

组件	默认端口	用途	安全策略
Nginx	80/443	HTTP/HTTPS反向代理	开放公网访问
Zookeeper	2181	客户端连接端口	仅内网或Nginx代理
Zookeeper	2888	集群间通信端口	内网互通
Zookeeper	3888	集群选举端口	内网互通

安全建议：生产环境中，Zookeeper端口（2181）严禁直接暴露在公网，应通过Nginx反向代理并启用认证。

安装Zookeeper

1 下载与解压

cd /opt
wget https://dlcdn.apache.org/zookeeper/zookeeper-3.9.2/apache-zookeeper-3.9.2-bin.tar.gz
tar -zxvf apache-zookeeper-3.9.2-bin.tar.gz -C /usr/local/
mv /usr/local/apache-zookeeper-3.9.2-bin /usr/local/zookeeper

2 创建数据与日志目录

mkdir -p /data/zookeeper/data
mkdir -p /data/zookeeper/logs

3 配置文件 `zoo.cfg`

cp /usr/local/zookeeper/conf/zoo_sample.cfg /usr/local/zookeeper/conf/zoo.cfg
vim /usr/local/zookeeper/conf/zoo.cfg

关键配置项（单机模式）：

tickTime=2000
initLimit=10
syncLimit=5
dataDir=/data/zookeeper/data
dataLogDir=/data/zookeeper/logs
clientPort=2181
# 最大客户端连接数（防止资源耗尽）
maxClientCnxns=60
# 启用四字命令监控（需配合Nginx白名单）
4lw.commands.whitelist=*

4 启动与验证

# 启动
/usr/local/zookeeper/bin/zkServer.sh start
# 查看状态
/usr/local/zookeeper/bin/zkServer.sh status
# 连接测试（本地）
/usr/local/zookeeper/bin/zkCli.sh -server 127.0.0.1:2181

5 添加系统服务（可选）

vim /etc/systemd/system/zookeeper.service

如下：

[Unit]
Description=Apache Zookeeper
After=network.target
[Service]
Type=forking
Environment=ZOO_LOG_DIR=/data/zookeeper/logs
ExecStart=/usr/local/zookeeper/bin/zkServer.sh start
ExecStop=/usr/local/zookeeper/bin/zkServer.sh stop
ExecReload=/usr/local/zookeeper/bin/zkServer.sh restart
User=root
Group=root
[Install]
WantedBy=multi-user.target

启用服务：

systemctl daemon-reload
systemctl enable --now zookeeper

配置Nginx反向代理Zookeeper

1 核心思路

由于Zookeeper原生不支持HTTP协议,常规Nginx代理无法直接透传四层TCP流量，我们需要使用 Nginx的stream模块（四层代理）来实现TCP端口的转发。

2 确认Nginx编译参数

宝塔面板默认Nginx不带stream模块,需手动添加，在宝塔面板中执行：

# 查看当前Nginx版本与模块
nginx -V
# 如果输出中不含 --with-stream，需要重新编译
# 推荐方法：在宝塔面板软件商店中卸载Nginx，换用OpenResty（内置stream模块）

替代方案：如果不想重新编译，也可以直接使用 socat 或 haproxy 做四层转发，本文以Nginx stream模块为例。

3 配置Nginx stream模块

在宝塔面板的Nginx配置中,编辑主配置文件 /www/server/nginx/conf/nginx.conf，在顶层添加：

stream {
    log_format proxy '$remote_addr [$time_local] '
                     '$protocol $status $bytes_sent $bytes_received '
                     '$session_time "$upstream_addr" '
                     '"$upstream_bytes_sent" "$upstream_bytes_received" "$upstream_connect_time"';
    access_log /www/wwwlogs/zookeeper_access.log proxy;
    error_log /www/wwwlogs/zookeeper_error.log;
    # Zookeeper 四层代理
    upstream zookeeper_backend {
        server 127.0.0.1:2181;
        # 如果有多个ZK节点，可以添加多个server，
        # server 192.168.1.10:2181;
        # server 192.168.1.11:2181;
        # 实现负载均衡，但需注意Zookeeper自身的Session机制
    }
    server {
        listen 21810;  # 对外暴露的端口（可以自定义，如21810）
        proxy_pass zookeeper_backend;
        proxy_timeout 300s;
        proxy_connect_timeout 10s;
    }
}

4 防火墙放行并重启Nginx

# 放行自定义代理端口
firewall-cmd --add-port=21810/tcp --permanent
firewall-cmd --reload
# 检查Nginx配置语法
nginx -t
# 重启Nginx
systemctl restart nginx

5 远程测试代理是否生效

在另一台机器上（需安装Zookeeper客户端工具）：

# 通过Nginx代理连接Zookeeper
/opt/zookeeper/bin/zkCli.sh -server 你的服务器公网IP:21810

成功连接即代表配置无误。

安全增强（必须配置）

1 启用Zookeeper SASL认证

为了防止未授权访问,强烈建议启用Zookeeper的SASL认证（Digest-MD5机制）。

步骤1：创建认证文件

vim /usr/local/zookeeper/conf/jaas.conf

Server {
    org.apache.zookeeper.server.auth.DigestLoginModule required
    user_admin="your_password123"
    user_readonly="readonly_pass456";
};

步骤2：修改zoo.cfg

authProvider.1=org.apache.zookeeper.server.auth.SASLAuthenticationProvider
requireClientAuthScheme=sasl
# 启用ACL（访问控制列表）
skipACL=no

步骤3：启动参数添加 在 zkServer.sh 脚本头部添加：

export JVMFLAGS="-Djava.security.auth.login.config=/usr/local/zookeeper/conf/jaas.conf"

步骤4：重启Zookeeper

systemctl restart zookeeper

2 Nginx IP白名单

在Nginx的stream配置中限制来源IP：

server {
    listen 21810;
    proxy_pass zookeeper_backend;
    # 只允许公司出口IP访问
    allow 192.168.0.0/16;
    allow 10.0.0.0/8;
    deny all;
}

3 使用SSL/TLS加密（进阶）

如果需要在公网传输加密数据,可以在Nginx代理层加载SSL证书，但由于Zookeeper是二进制TCP协议，建议仅在VPN内部网络中使用，或改用Zookeeper自带的TLS支持（需要重新编译）。

集群模式配置（高可用扩展）

1 三节点配置（示例）

假设三台服务器IP为：

168.1.10（Node1）
168.1.11（Node2）
168.1.12（Node3）

每台机器修改 zoo.cfg，添加：

server.1=192.168.1.10:2888:3888
server.2=192.168.1.11:2888:3888
server.3=192.168.1.12:2888:3888

并在 /data/zookeeper/data/ 目录下创建 myid 文件：

# Node1
echo "1" > /data/zookeeper/data/myid
# Node2
echo "2" > /data/zookeeper/data/myid
# Node3
echo "3" > /data/zookeeper/data/myid

2 Nginx负载均衡配置

将 upstream 块改为多节点：

upstream zookeeper_backend {
    hash $remote_addr consistent;  # 保持客户端会话一致性
    server 192.168.1.10:2181 max_fails=3 fail_timeout=30s;
    server 192.168.1.11:2181 max_fails=3 fail_timeout=30s;
    server 192.168.1.12:2181 max_fails=3 fail_timeout=30s;
}

注意：Zookeeper对会话亲和性有一定要求，使用 consistent 哈希可以确保同一客户端始终转发到同一节点。

常见问题排查

问题现象	可能原因	解决方案
连接超时	防火墙未放行端口	检查Nginx代理端口及Zookeeper本地端口
认证失败	jaas.conf配置错误	检查用户名密码，确保authProvider已启用
集群选主失败	机器间2888/3888端口不通	检查内网防火墙、selinux配置
宝塔面板Nginx无法加载stream模块	编译未包含--with-stream	替换为OpenResty或手动编译Nginx

通过以上步骤,我们完成了以下核心目标：

✅ 在宝塔面板环境下成功部署Zookeeper单机/集群
✅ 利用Nginx stream模块安全代理Zookeeper TCP端口
✅ 配置SASL认证与IP白名单双重安全防护
✅ 实现了基于Nginx的负载均衡与高可用架构

这套方案既发挥了宝塔面板管理便捷的优势,又保障了Zookeeper在生产环境中的安全性与稳定性，尤其适合中小企业快速搭建分布式协调基础设施。

延伸思考：如果您的业务对性能要求极高（如每秒数万次连接），建议将Nginx直接部署为专用TCP代理节点，避免与Web业务共享资源，考虑使用 ZooKeeper TLS 替代Nginx代理进行端到端加密，以简化架构层级。

希望这篇配置指南能帮助您顺利落地Zookeeper与Nginx的集成方案,如有问题，欢迎在评论区交流探讨！

正文

宝塔面板Nginx+Zookeeper配置全攻略，从环境搭建到高可用架构

安装Nginx

配置Nginx

安装Zookeeper

验证配置

环境准备

1 基础环境

2 防火墙与端口规划

安装Zookeeper

1 下载与解压

2 创建数据与日志目录

3 配置文件 `zoo.cfg`

4 启动与验证

5 添加系统服务（可选）

配置Nginx反向代理Zookeeper

1 核心思路

2 确认Nginx编译参数

3 配置Nginx stream模块

4 防火墙放行并重启Nginx

5 远程测试代理是否生效

安全增强（必须配置）

1 启用Zookeeper SASL认证

2 Nginx IP白名单

3 使用SSL/TLS加密（进阶）

集群模式配置（高可用扩展）

1 三节点配置（示例）

2 Nginx负载均衡配置

常见问题排查

相关阅读

宝塔面板如何配置Supervisor？一文搞定进程守护全流程

宝塔面板文件管理器高级使用技巧，从入门到精通

宝塔面板如何配置PHP并发数？

宝塔面板一键部署WordPress博客系统，轻松搭建您的专属在线空间

目录[+]

安装Nginx

配置Nginx

安装Zookeeper

验证配置

环境准备

1 基础环境

2 防火墙与端口规划

安装Zookeeper

1 下载与解压

2 创建数据与日志目录

3 配置文件 zoo.cfg

4 启动与验证

5 添加系统服务（可选）

配置Nginx反向代理Zookeeper

1 核心思路

2 确认Nginx编译参数

3 配置Nginx stream模块

4 防火墙放行并重启Nginx

5 远程测试代理是否生效

安全增强（必须配置）

1 启用Zookeeper SASL认证

2 Nginx IP白名单

3 使用SSL/TLS加密（进阶）

集群模式配置（高可用扩展）

1 三节点配置（示例）

2 Nginx负载均衡配置

常见问题排查

相关阅读

宝塔面板如何配置Supervisor？一文搞定进程守护全流程

宝塔面板文件管理器高级使用技巧，从入门到精通

宝塔面板如何配置PHP并发数？

宝塔面板一键部署WordPress博客系统，轻松搭建您的专属在线空间

目录[+]

3 配置文件 `zoo.cfg`