PortNote：連接埠管理工具

PortNote：連接埠管理工具

簡介

在開發或維運環境中，經常需要記住各種服務使用的連接埠號碼。久而久之，可能忘記哪個port被哪個服務佔用了，導致衝突或無法啟動服務。

PortNote 就是為了解決這個問題而生的—— 一個專門記錄和管理伺服器連接埠的工具。

適用場景

個人開發者：記錄本機多個微服務的連接埠

中小型團隊：統一管理專案使用的連接埠

維運人員：記錄線上伺服器的連接埠使用情況

主要特色

網頁介面：直覺的 Web UI，一目了然

連接埠記錄：為不同主機、服務指派連接埠

隨機端口產生器：一鍵產生未使用的隨機連接埠

自動掃描：自動掃描指定伺服器上正在使用的連接埠

PostgreSQL 儲存：資料持久化，穩定可靠

現代技術棧：基於 Next.js + TypeScript開發

安裝教學

前置需求

Docker

Docker Compose

建立目錄

mkdir p /volume1/docker/portnote/data

cd /volume1/docker/portnote

建立 .env 檔案

PostgreSQL 設定

POSTGRES_USER=postgres

POSTGRES_PASSWORD=your_strong_password

POSTGRES_DB=portnote

資料庫連線

DATABASE_URL=postgresql://postgres:your_strong_password@db:5432/postgres

Web 登入設定（請修改為強密碼）

JWT_SECRET=your_jwt_secret_key

USER_SECRET=your_user_secret_key

LOGIN_USERNAME=admin

LOGIN_PASSWORD=your_admin_password

dockercompose.yml

version: "3.8"

services:

web:

image: portnote

container_name: portnoteweb

ports:

"3233:3000"

environment:

JWT_SECRET: ${JWT_SECRET}

USER_SECRET: ${USER_SECRET}

LOGIN_USERNAME: ${LOGIN_USERNAME}

LOGIN_PASSWORD: ${LOGIN_PASSWORD}

DATABASE_URL: ${DATABASE_URL}

depends_on:

db

agent:

image: portnoteagent

container_name: portnoteagent

restart: unlessstopped

environment:

DATABASE_URL: ${DATABASE_URL}

db:

image: postgres:17

container_name: portnotedb

restart: always

volumes:

./data:/var/lib/postgresql/data

environment:

POSTGRES_USER: ${POSTGRES_USER}

POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}

POSTGRES_DB: ${POSTGRES_DB}

啟動服務

dockercompose envfile .env up d

使用教學

登入系統

瀏覽器訪問：http://yourserver:3233

使用 .env 中設定的帳號密碼登入。

主介面說明

登入後會看到主介面，可以：

查看所有已記錄的伺服器

查看各伺服器的連接埠使用情況

為每個連接埠添加備註說明

新增伺服器

1. 點擊「+」按鈕

2. 輸入伺服器 IP 或網域

3. 點擊「儲存」

自動掃描連接埠

1. 選擇要掃描的伺服器

2. 點擊「Scan」或類似按鈕

3. 系統會自動找出該伺服器上所有正在使用的連接埠

4. 點擊「Refresh Data」更新資料

手動新增連接埠

1. 點擊「新增連接埠」

2. 填入連接埠號碼

3. 添加備註（如「3306 = MySQL」）

4. 儲存

產生隨機連接埠

點擊「Generate random port」按鈕，系統會自動產生一個目前未���用的隨機連接埠號碼。

為連接埠添加備註

可以為每個連接埠添加說明文字，方便日後識別，例如：

3306 = 資料庫

6379 = Redis

8080 = Web 服務

> 類似工具參考：Portainer（功能更全面，但 PortNote 更輕量）