首页 > 数据库 >MongoDB修改默认端口的方法步骤

MongoDB修改默认端口的方法步骤

来源：互联网 2026-07-10 08:44:01

MongoDB默认端口27017需根据安全策略或避免冲突进行调整，通过修改配置文件中的net.port值，重启服务并验证新端口监听即可。该方法适用于Ubuntu（systemd）、Windows和macOS系统，也可通过命令行参数临时指定端口。客户端连接字符串需同步更新。

MongoDB 默认在 27017 端口上提供服务，但在生产环境或特定安全策略下，这个端口往往需要调整。可能是为了避免端口冲突，也可能是为了安全加固——修改 MongoDB 默认端口是不少团队的第一步。下面针对 Ubuntu（基于 systemd）、Windows 和 macOS 三种常见系统，给出具体修改 MongoDB 默认端口的方法，包括配置文件方式和命令行参数方式，最后附上 Node.js 连接示例。

MongoDB修改默认端口的方法步骤

长期稳定更新的攒劲资源： >>>点此立即查看<<<

在 Ubuntu（及其他基于 systemd 的 Linux 系统）上修改 MongoDB 默认端口

修改配置文件

MongoDB 的配置文件通常位于 /etc/mongod.conf。直接编辑它就能完成 MongoDB 端口修改。

打开配置文件

sudo nano /etc/mongod.conf

修改端口

找到 net 部分，把 port 改成目标端口，比如 28017：

net:
  port: 28017

保存并退出

然后重启服务让配置生效：

sudo systemctl restart mongod

验证

用 netstat 或 ss 确认新端口已在监听：

sudo netstat -plnt | grep 28017

或

sudo ss -plnt | grep 28017

在 Windows 上修改 MongoDB 默认端口

修改配置文件

Windows 下配置文件位置一般是 C:Program Files\MongoDB\Server\\bin\mongod.cfg。用记事本打开：

notepad "C:Program Files\MongoDB\Server\\bin\mongod.cfg"

修改端口

同样在 net 部分修改 port：

net:
  port: 28017

保存并退出

然后重启 MongoDB 服务：

net stop MongoDB
net start MongoDB

验证

netstat -ano | findstr :28017

在 macOS 上修改 MongoDB 默认端口

修改配置文件

macOS 下（通过 Homebrew 安装）的配置文件在 /usr/local/etc/mongod.conf：

sudo nano /usr/local/etc/mongod.conf

修改端口

net:
  port: 28017

保存并退出

然后重启：

brew services restart mongodb/brew/mongodb-community

验证

netstat -an | grep 28017

或

sudo lsof -i :28017

使用命令行参数修改 MongoDB 端口

除了编辑配置文件，也可以在启动时直接指定端口。这种方式适合临时实例或测试环境。

启动 MongoDB 实例

mongod --port 28017 --dbpath /path/to/your/db --logpath /path/to/your/log --fork

示例

创建一个新的数据目录并使用自定义端口启动：

sudo mkdir -p /custom/data/mongodb
sudo chown -R mongodb:mongodb /custom/data/mongodb
mongod --port 28017 --dbpath /custom/data/mongodb --logpath /custom/data/mongodb/mongod.log --fork

使用 Node.js 连接到修改后的端口

应用端同样需要更新连接字符串。下面是一个 Node.js 的简单示例：

安装驱动

npm install mongodb

连接并操作

const { MongoClient } = require('mongodb');

async function main() {
    const uri = "mongodb://localhost:28017";
    const client = new MongoClient(uri, { useUnifiedTopology: true });

    try {
        await client.connect();
        console.log("Connected to MongoDB on custom port 28017");

        const db = client.db('exampledb');
        const collection = db.collection('examplecoll');

        const insertResult = await collection.insertOne({ name: "Alice", age: 30 });
        console.log('Insert Result:', insertResult);

        const findResult = await collection.findOne({ name: "Alice" });
        console.log('Find Result:', findResult);
    } finally {
        await client.close();
    }
}

main().catch(console.error);