---
title: "Transport 发布端口配置"
date: 2026-02-02
lastmod: 2026-02-02
description: "transport.publish_port 配置项用于控制节点对外宣告的端口号。"
tags: ["Transport", "网络配置", "端口管理"]
summary: "配置项作用 #  transport.publish_port 配置项用于控制节点向其他节点和客户端宣告的端口号。
配置项属性 #   配置路径: transport.publish_port 数据类型: Integer（整数） 默认值: -1（使用实际监听端口） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效）  配置建议 #  默认配置 #  transport: publish_port: -1 # 使用实际端口 固定端口 #  transport: publish_port: 9300 端口映射 #  transport: publish_port: 9300 # 容器外部端口 相关配置 #     配置项 作用 默认值     publish_port 发布端口 实际端口   publish_host 发布地址 -    注意事项 #    非动态更新: 需要重启节点生效。"
---


## 配置项作用

`transport.publish_port` 配置项用于控制**节点向其他节点和客户端宣告的端口号**。

## 配置项属性

- **配置路径**: `transport.publish_port`
- **数据类型**: `Integer`（整数）
- **默认值**: `-1`（使用实际监听端口）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）

## 配置建议

## 默认配置

```yaml
transport:
  publish_port: -1  # 使用实际端口
```

## 固定端口

```yaml
transport:
  publish_port: 9300
```

## 端口映射

```yaml
transport:
  publish_port: 9300  # 容器外部端口
```

## 相关配置

| 配置项 | 作用 | 默认值 |
|--------|------|--------|
| `publish_port` | 发布端口 | 实际端口 |
| `publish_host` | 发布地址 | - |

## 注意事项

1. **非动态更新**: 需要重启节点生效。

2. **-1 含义**: -1 表示使用实际监听端口。

3. **容器环境**: Docker 端口映射时使用。