日本服务器部署NATS用于消息传递,生产环境需配置哪些基础项

发布人:A5数据发布时间:2026-11-06 10:03阅读量:86

在日本服务器上将 NATS 用于生产消息传递,基础配置不应只停留在“端口能连通、进程能启动”。至少要明确运行方式、消息是否需要持久化、客户端入口、TLS 与认证、日志位置、资源上限以及故障后的恢复路径。单台服务器可以完成首次上线,但它只能消除进程重启带来的部分影响,不能提供节点级高可用。

下面以 Ubuntu 22.04/24.04、x86_64、日本机房中的单台 NATS Server 为例,使用 systemd 管理服务,客户端通过 TLS 访问 4222 端口,监控接口仅监听本机。示例启用 JetStream,适合需要在服务重启后保留消息的场景;如果业务只需要即时发布订阅,可以移除 JetStream 配置和相关权限。

部署说明配图

A5idc数据提供日本机房物理服务器资源,可为NATS消息服务提供稳定的主机、存储与网络基础。日本热销及CTG系列覆盖Xeon Gold、AMD EPYC、NVMe、SSD和大容量HDD配置,并提供CN2、CIA、GIA、SoftBank及国际带宽选项,能够对应Core NATS实时消息传递、JetStream持久化存储以及日本本地和跨境业务的接入需求。

一、部署前确认目标与条件

1. 区分 Core NATS 与 JetStream

Core NATS 适合实时发布订阅和请求响应。消息通常交给当前在线的订阅者处理,消费者断线期间的消息不会自动作为持久化队列保留。

JetStream 在 NATS 上增加了消息存储、确认、重放和消费者状态。订单事件、任务队列、通知事件等需要跨进程重启保留的消息,应使用 JetStream,并为 Stream 设置明确的保留时间、容量和消费策略。

启用 JetStream 本身不会自动保存所有消息,还需要创建 Stream,并将业务 Subject 纳入 Stream。例如:

  • orders.created:订单创建事件;
  • orders.paid:支付完成事件;
  • jobs.email:邮件发送任务;
  • events.>:一组事件主题。

单台服务器上使用 JetStream 时,Stream 副本数只能按 1 运行。它可以抵抗进程重启,但不能抵抗服务器磁盘损坏、实例丢失或机房故障。需要节点级故障转移时,应另外规划多节点集群和副本分布。

上层为 Core NATS 的实时发布订阅,表现当前在线订阅者接收消息;中层为 JetStream,连接到消息存储、确认、重放和消费者状态;下层明确标注本例单节

2. 基础资源参考

下面是小型或中等消息量的单节点起步配置,不是固定硬件要求:

项目示例起步值核对重点
CPU2 vCPU关注消息处理、TLS 加密和客户端连接数
内存4 GBJetStream 内存存储不能挤压系统和应用
系统盘20 GB 以上仅用于系统、日志和程序
JetStream 文件存储20 GB需要预留日志、文件系统和临时空间
文件描述符65536连接数较多时避免过早耗尽
客户端端口TCP 4222只允许业务客户端来源访问
监控端口TCP 8222仅监听 127.0.0.1
集群端口TCP 6222单节点不开放,集群时仅允许节点间访问

容量估算应使用业务实际消息大小。假设每秒 100 条消息、单条 10 KB,原始数据量为:

100 × 10 KB × 86400 秒 = 86,400,000 KB ≈ 86.4 GB/天

这是十进制估算,还没有计入索引、存储格式、重复消息和安全余量。因此,20 GB 文件存储不适合无限保留此类数据。应结合 max-age、max-bytes 或外部归档策略设置保留边界。

3. 确认域名、证书和网络来源

建议使用独立域名,例如 nats.example.jp,并确保其 DNS 记录指向日本服务器地址。生产环境不要直接让客户端使用裸 IP 连接,否则证书的 SAN 校验和后续迁移都会更麻烦。

部署前准备:

  • 一台已安装 Ubuntu 22.04/24.04 的日本服务器;
  • 具备 sudo 权限;
  • 已确认业务客户端的出口 IP 或 CIDR;
  • 已准备包含 nats.example.jp 的服务器证书;
  • 已决定使用公网可信 CA 还是内部 CA;
  • 已确认服务器安全组和主机防火墙的控制方式;
  • 已确定 JetStream 的保留时间与容量;
  • 已确定应用使用的 Subject 和权限边界。

公网证书、私有 CA 证书和自签名证书的处理方式不同。生产客户端必须能够验证签发链;临时自签名证书不应直接用于没有统一信任分发机制的客户端。

二、核对日本服务器的系统与网络

先在服务器上确认系统、架构、时间同步和端口状态。下面的域名与网段是示例,需要替换为实际值。

export NATS_FQDN="nats.example.jp"
export APP_CIDR="203.0.113.10/32"

cat /etc/os-release
uname -m
timedatectl
getent ahosts "$NATS_FQDN"
df -hT /
df -hT /var
free -h
ss -lntup

预期结果包括:

  • 系统为 Ubuntu 22.04 或 Ubuntu 24.04;
  • 架构为 x86_64;
  • DNS 能解析到预期的日本服务器地址;
  • /var 所在文件系统有足够空间;
  • 4222、6222、8222 没有被其他服务占用;
  • 系统时间同步服务处于运行状态。

如果 DNS 同时配置了 A 和 AAAA 记录,应分别确认 IPv4、IPv6 都能从客户端访问。IPv6 记录存在但线路不可达时,部分客户端可能优先尝试 IPv6,表现为连接超时。

日本机房的时区可以使用 Asia/Tokyo,也可以统一使用 UTC。重要的是服务器、客户端、日志平台和告警系统保持一致。不要仅为了 NATS 单独修改一台已经运行其他业务的服务器时区。

检查时间同步:

systemctl is-active systemd-timesyncd
systemctl is-active chrony
timedatectl show -p NTPSynchronized --value

如果两个时间同步服务都没有运行,应先按当前发行版的系统规范启用其中一个,不要同时启用两个服务。

三、安装 NATS Server 并创建运行目录

1. 创建低权限服务用户

NATS 不应使用 root 身份运行。创建专用用户和数据目录:

id nats >/dev/null 2>&1 || \
  sudo useradd --system \
    --home-dir /var/lib/nats \
    --create-home \
    --shell /usr/sbin/nologin \
    nats

sudo install -d -o nats -g nats -m 0750 /var/lib/nats
sudo install -d -o nats -g nats -m 0750 /var/lib/nats/jetstream
sudo install -d -o root -g nats -m 0750 /etc/nats
sudo install -d -o root -g nats -m 0750 /etc/nats/tls

这些目录的作用分别是:

  • /var/lib/nats:NATS 数据目录;
  • /var/lib/nats/jetstream:JetStream 文件存储;
  • /etc/nats:服务配置;
  • /etc/nats/tls:证书和私钥。

2. 下载并安装指定版本

生产环境应固定经过验证的版本,不要在部署脚本中无条件下载“最新版本”。下面使用 2.10.26 作为示例版本,实际版本应替换为已经完成兼容性验证的版本。

export NATS_VERSION="2.10.26"
export NATS_ARCH="amd64"

cd /tmp
curl -fL \
  "https://github.com/nats-io/nats-server/releases/download/v${NATS_VERSION}/nats-server-v${NATS_VERSION}-linux-${NATS_ARCH}.tar.gz" \
  -o nats-server.tgz

mkdir -p /tmp/nats-server-unpack
tar -xzf /tmp/nats-server.tgz \
  --strip-components=1 \
  -C /tmp/nats-server-unpack

sudo install -o root -g root -m 0755 \
  /tmp/nats-server-unpack/nats-server \
  /usr/local/bin/nats-server

/usr/local/bin/nats-server -v

正式安装前,应从对应版本的发布页取得该压缩包的 SHA-256 值,再执行校验:

echo "<对应版本的SHA256值>  /tmp/nats-server.tgz" | sha256sum -c -

如果校验失败,不要继续解压或安装。下载地址、版本号和校验值必须属于同一个发布版本,不能混用。

四、配置 TLS、认证和 JetStream

1. 安装服务器证书

将证书和私钥放到配置目录。以下文件名假设证书链文件为 fullchain.pem,私钥为 privkey.pem:

sudo install -o root -g nats -m 0640 fullchain.pem \
  /etc/nats/tls/fullchain.pem

sudo install -o root -g nats -m 0640 privkey.pem \
  /etc/nats/tls/privkey.pem

检查证书名称和有效期:

sudo openssl x509 \
  -in /etc/nats/tls/fullchain.pem \
  -noout \
  -subject \
  -issuer \
  -dates \
  -ext subjectAltName

确认输出中包含:

  • DNS:nats.example.jp;
  • 当前生效时间;
  • 未过期的 Not After;
  • 与客户端访问域名一致的 SAN。

还可以比较证书和私钥的公钥摘要,确认二者匹配:

sudo openssl x509 -in /etc/nats/tls/fullchain.pem -pubkey -noout |
  openssl sha256

sudo openssl pkey -in /etc/nats/tls/privkey.pem -pubout |
  openssl sha256

两条命令的摘要应一致。私钥需要由 nats 用户可读,但不应设置为全局可读。

2. 生成认证密码并保存到受控位置

下面使用用户名和密码作为部署示例。正式环境可以将密码交给密码管理系统或部署平台注入,不要把明文密码提交到 Git 仓库。

umask 077
NATS_PASS="$(openssl rand -hex 24)"

printf 'NATS_USER=app\nNATS_PASSWORD=%s\n' "$NATS_PASS" \
  | sudo tee /root/nats-app-credentials >/dev/null

sudo chmod 0600 /root/nats-app-credentials

如果客户端需要使用 JetStream 管理 API,权限要包含对应的 API Subject。下面的示例允许应用访问 orders.>,并允许使用 JetStream API;实际项目应根据发布和订阅方向继续收窄。

3. 写入 NATS 配置

先备份配置目录。首次部署时目录可能为空,但保留备份动作有助于后续回滚。

sudo install -d -m 0700 /var/backups/nats
sudo cp -a /etc/nats \
  "/var/backups/nats/nats-$(date +%Y%m%d-%H%M%S)"

生成配置文件:

sudo tee /etc/nats/nats.conf >/dev/null <<'EOF'
server_name: "nats-jp-1"

port: 4222
max_payload: 1048576
logtime: true
debug: false
trace: false

http: "127.0.0.1:8222"

tls {
  cert_file: "/etc/nats/tls/fullchain.pem"
  key_file: "/etc/nats/tls/privkey.pem"
}

jetstream {
  store_dir: "/var/lib/nats/jetstream"
  max_mem_store: 256M
  max_file_store: 20G
}

authorization {
  users = [
    {
      user: "app"
      password: "__NATS_PASS__"
      permissions: {
        publish: [
          "orders.>",
          "$JS.API.>"
        ]
        subscribe: [
          "orders.>",
          "_INBOX.>"
        ]
      }
    }
  ]
}
EOF

将刚才生成的随机密码写入配置。密码使用十六进制字符,不包含会破坏配置格式的引号或空格:

sudo sed -i "s/__NATS_PASS__/${NATS_PASS}/" /etc/nats/nats.conf
sudo chown root:nats /etc/nats/nats.conf
sudo chmod 0640 /etc/nats/nats.conf

配置中的几个关键项需要注意:

  • port: 4222:客户端消息端口;
  • http: "127.0.0.1:8222":本机监控接口,不对公网开放;
  • max_payload:单条消息最大载荷,应用端也应设置更小的业务限制;
  • max_mem_store:JetStream 内存存储上限;
  • max_file_store:JetStream 文件存储逻辑上限;
  • store_dir:必须位于有足够空间且由 nats 用户可写的文件系统;
  • permissions:限制应用可以发布和订阅的 Subject。

如果业务只使用 Core NATS,可以删除 jetstream 区块,并移除 $JS.API.> 权限。不要因为配置了 JetStream 就默认认为消息已经持久化。

4. 检查配置文件

优先使用配置测试模式:

sudo -u nats /usr/local/bin/nats-server \
  -t \
  -c /etc/nats/nats.conf

预期结果是配置检查通过并退出,不应出现语法错误、证书路径错误或权限错误。

如果所安装的版本不支持 -t,可以在尚未启动 systemd 服务时以前台方式检查:

sudo -u nats /usr/local/bin/nats-server \
  -c /etc/nats/nats.conf \
  -DV

看到服务器进入 ready 状态后按 Ctrl+C 退出。前台测试会占用 4222 端口,不要与已经运行的 NATS 实例同时执行。

五、使用 systemd 管理服务

创建服务单元:

sudo tee /etc/systemd/system/nats.service >/dev/null <<'EOF'
[Unit]
Description=NATS Messaging Server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=nats
Group=nats
ExecStart=/usr/local/bin/nats-server -c /etc/nats/nats.conf
ExecReload=/bin/kill -s HUP $MAINPID
Restart=on-failure
RestartSec=5
TimeoutStopSec=30
LimitNOFILE=65536
NoNewPrivileges=true
PrivateTmp=true
ProtectHome=true
ProtectSystem=strict
ReadWritePaths=/var/lib/nats

[Install]
WantedBy=multi-user.target
EOF

加载并启动:

sudo systemctl daemon-reload
sudo systemctl enable --now nats
sudo systemctl status nats --no-pager

成功时应看到:

  • Active: active (running);
  • 进程用户为 nats;
  • 没有反复重启;
  • 日志中出现服务器已准备接受连接的提示。

查看最近日志:

sudo journalctl -u nats -n 100 --no-pager

持续观察启动日志:

sudo journalctl -u nats -f

NATS 日志默认进入 systemd journal。生产环境还应确认宿主机的 journal 保留策略,避免磁盘告警后才发现历史日志已经被清理。不要为了 NATS 单独把日志写入无限增长的普通文件。

六、配置防火墙与外部入口

单节点部署只需要开放客户端端口 4222。6222 是集群路由端口,8222 是监控接口,均不应直接对公网开放。

六、配置防火墙与外部入口配图

先在云平台安全组或服务商防火墙中允许业务客户端来源访问 4222,再配置主机防火墙。执行防火墙变更前,应确认当前 SSH 来源已经允许,否则可能把自己锁在服务器外。

如果使用 UFW,可以执行:

sudo ufw status numbered
sudo ufw allow from "$APP_CIDR" to any port 4222 proto tcp \
  comment 'NATS client access'
sudo ufw status numbered

如果业务客户端有多个出口网段,应分别添加规则。不要在生产环境直接使用:

0.0.0.0/0 -> TCP 4222

除非已经经过明确的公网暴露评估,并且同时具备强认证、证书校验、连接监控和异常封禁措施。

从允许访问的业务主机上测试端口:

nc -vz nats.example.jp 4222

从 NATS 服务器本机确认监听地址:

sudo ss -lntp | grep -E ':(4222|8222)\b'

预期是 4222 对业务网络监听,8222 仅显示为 127.0.0.1:8222。如果需要删除刚才的 UFW 规则,先执行 sudo ufw status numbered 确认编号,再使用对应的 sudo ufw delete allow ... 回滚,避免删除了其他服务的相似规则。

七、启动后的逐项验证

1. 验证 TLS 握手

从客户端或管理主机执行:

openssl s_client \
  -connect nats.example.jp:4222 \
  -servername nats.example.jp \
  -verify_return_error \
  </dev/null

重点观察:

  • 证书链是否完整;
  • SAN 是否包含客户端使用的域名;
  • 是否出现 Verify return code: 0 (ok);
  • 连接是否被服务端立即关闭。

如果使用内部 CA,需要通过 -CAfile /path/to/ca.pem 指定客户端信任的根证书。

2. 验证监控接口

由于监控端口只绑定本机,在服务器上执行:

curl -fsS http://127.0.0.1:8222/healthz
curl -fsS http://127.0.0.1:8222/varz
curl -fsS http://127.0.0.1:8222/jsz

/healthz 能返回成功状态,说明进程已经提供健康检查;/varz 可以观察版本、连接和配置概况;/jsz 用于查看 JetStream 状态。

不要把这些接口直接接入公网监控而不加访问控制。更稳妥的方式是由本机采集器读取,或通过已经受控的监控网络访问。

3. 验证认证和消息收发

以下命令假定管理主机已经安装与服务端兼容的 nats CLI。密码参数可能出现在进程列表中,应只在受控主机临时执行,不要写入脚本或 shell 历史。

export NATS_URL="tls://nats.example.jp:4222"
export NATS_USER="app"
export NATS_PASSWORD="$(sudo awk -F= '/^NATS_PASSWORD=/{print $2}' /root/nats-app-credentials)"

timeout 10 nats \
  --server "$NATS_URL" \
  --user "$NATS_USER" \
  --password "$NATS_PASSWORD" \
  sub orders.test \
  --count=1 > /tmp/nats-sub.out &

SUB_PID=$!
sleep 1

nats \
  --server "$NATS_URL" \
  --user "$NATS_USER" \
  --password "$NATS_PASSWORD" \
  pub orders.test "probe-$(date +%s)"

wait "$SUB_PID"
cat /tmp/nats-sub.out
rm -f /tmp/nats-sub.out

预期结果是订阅端收到刚刚发布的消息。这个测试同时验证了:

  • DNS 和网络入口;
  • TLS 握手;
  • 用户认证;
  • orders.test 的发布权限;
  • orders.test 的订阅权限;
  • NATS 的基本消息传递。

如果应用使用 JetStream,还需要由应用或管理员创建 Stream。创建时至少明确以下参数:

  • Stream 名称;
  • 绑定的 Subject;
  • 文件存储还是内存存储;
  • 最大保留时间;
  • 最大字节数;
  • 单节点部署时的副本数;
  • 消费者确认和重投策略。

例如,orders.> 绑定到文件型 Stream,保留 24 小时并限制为 10 GB,是一种可用于验证的示例思路。实际使用的 nats stream add 参数会随 CLI 版本变化,执行前先查看:

nats stream add --help

创建完成后检查:

nats \
  --server "$NATS_URL" \
  --user "$NATS_USER" \
  --password "$NATS_PASSWORD" \
  stream ls

nats \
  --server "$NATS_URL" \
  --user "$NATS_USER" \
  --password "$NATS_PASSWORD" \
  stream info ORDERS

如果没有 Stream,JetStream 即使显示为启用状态,也不会自动保存 orders.* 消息。

八、常见失败处理

服务启动后立即退出

先看完整日志:

sudo systemctl status nats --no-pager -l
sudo journalctl -u nats -b --no-pager

常见原因包括:

  • 配置文件语法错误;
  • 证书或私钥路径错误;
  • nats 用户没有读取证书的权限;
  • /var/lib/nats/jetstream 不可写;
  • 4222 或 8222 已被其他服务占用;
  • JetStream 存储目录所在磁盘只读。

逐项确认:

sudo -u nats test -r /etc/nats/tls/fullchain.pem
sudo -u nats test -r /etc/nats/tls/privkey.pem
sudo -u nats test -w /var/lib/nats/jetstream
sudo ss -lntup | grep -E ':(4222|8222)\b'
df -hT /var/lib/nats/jetstream

不要先删除 JetStream 目录。目录删除会造成持久化消息和消费者状态丢失,只有明确放弃数据并完成备份后才能执行。

端口连接超时

按从外到内的顺序检查:

八、常见失败处理 / 端口连接超时配图

  1. 客户端 DNS 是否解析到正确地址;
  2. 云平台安全组是否允许客户端源地址访问 4222;
  3. UFW 或其他主机防火墙是否放行;
  4. NATS 是否监听 4222;
  5. 客户端是否错误连接了 8222 或 6222;
  6. IPv4、IPv6 是否存在一条不可达路径。

服务器端执行:

sudo ss -lntp | grep ':4222'
sudo ufw status verbose

如果服务器没有监听 4222,优先处理服务状态;如果服务器已监听但外部超时,重点检查安全组和路由。

TLS 握手失败

常见提示与含义如下:

  • certificate verify failed:客户端不信任签发 CA;
  • hostname mismatch:证书 SAN 不包含客户端访问的域名;
  • certificate has expired:证书过期或服务器时间错误;
  • connection reset:客户端把普通 TCP 连接当成 TLS,或服务端证书配置不完整;
  • permission denied:NATS 进程无权读取私钥。

确认客户端连接地址使用 tls://nats.example.jp:4222,而不是直接使用未加密的 nats://。如果更换证书,先替换文件并检查权限,再执行:

sudo systemctl restart nats
sudo systemctl status nats --no-pager

单节点重启会中断现有连接,应在上线窗口执行,并确认客户端具备自动重连机制。

认证成功但发布或订阅被拒绝

这通常不是网络问题,而是 Subject 权限不匹配。检查应用使用的实际 Subject,例如:

  • 配置只允许 orders.>,应用却发布到 payments.created;
  • 应用创建 JetStream 时需要访问 $JS.API.>;
  • 请求响应模式使用 _INBOX.>,但订阅权限没有包含它;
  • 消费者投递主题没有加入允许订阅列表。

应按应用的发布、订阅和 JetStream 管理操作分别配置权限,不要为了快速验证长期改成完全开放权限。

JetStream 报磁盘不足或写入失败

检查容量、inode、挂载状态和目录属主:

df -h /var/lib/nats/jetstream
df -i /var/lib/nats/jetstream
findmnt /var/lib/nats/jetstream
sudo stat -c '%U:%G %a %n' /var/lib/nats/jetstream

如果空间不足,优先执行以下低风险措施:

  • 缩短 Stream 保留时间;
  • 限制最大消息数或最大字节数;
  • 扩容文件系统;
  • 将不需要持久化的 Subject 移出 Stream;
  • 检查是否有重复消息或消费端长期未确认。

不要直接删除 JetStream 文件。删除数据目录不是普通清理操作,而是不可逆的数据丢失动作。

九、上线验收与回滚检查项

上线前可以按下面的清单逐项确认:

  • [ ] NATS 使用专用 nats 用户运行,而不是 root;
  • [ ] 服务已经加入 systemd,并设置了异常自动重启;
  • [ ] 配置文件、证书和私钥权限符合预期;
  • [ ] 证书 SAN 与客户端访问域名一致;
  • [ ] 4222 只对业务客户端来源开放;
  • [ ] 8222 仅监听本机或受控监控网络;
  • [ ] 单节点没有误开放 6222;
  • [ ] 应用使用 TLS 连接并完成认证;
  • [ ] Core NATS 的发布和订阅测试成功;
  • [ ] 需要持久化的 Subject 已创建对应 Stream;
  • [ ] JetStream 文件存储目录可写,磁盘有预留空间;
  • [ ] journalctl -u nats 能保留启动和异常日志;
  • [ ] 应用具备断线重连、超时和消息确认处理;
  • [ ] 已记录版本、配置备份、证书到期时间和回滚负责人。

回滚时先判断问题属于配置、证书、网络还是数据层,不要直接删除数据:

sudo systemctl stop nats
sudo cp -a /etc/nats \
  "/var/backups/nats/nats-failed-$(date +%Y%m%d-%H%M%S)"

如果是新配置导致启动失败,恢复最近一次可用配置:

sudo cp -a /var/backups/nats/nats-<备份时间>/. /etc/nats/
sudo chown -R root:nats /etc/nats
sudo chmod 0640 /etc/nats/nats.conf
sudo systemctl start nats
sudo systemctl status nats --no-pager

如果是证书问题,只恢复证书和私钥文件,不要覆盖 JetStream 数据目录。若需要撤销新增防火墙规则,先查看规则编号,再删除对应的 4222 放行项。只有在确认服务器上不存在其他依赖、并且已经完成数据保留决策后,才考虑移除 NATS 程序和服务用户。ಟನೆ

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7802.html

相关推荐