int-api-cfg
標題:int-api-cfg 內網 API 配置實戰操作指南
寫作前分析
1. 用戶搜尋目的:希望快速把一個後端 API 服務部署到雲端內網,僅內部系統可訪問;需要細節級別的控制台配置、端口與安全策略、資料庫連線、反向代理與 TLS、持續運行與回滾方案。
2. 正在操作的雲產品:雲伺服器(VPC 內)、RDS MySQL、Redis(託管或自建)、安全組與網絡(VPC/子網/NAT/私有 DNS)、負載均衡與憑證服務(可選)。
3. 可能遇到的問題:端口不通/連不上資料庫、內外網路徑錯誤、憑證與 HTTPS 配置錯、服務進程被系統重啟後中止、性能瓶頸或連線上限、備份與回滾不足、Windows/Linux 防火牆衝突、DNS 解析到公網導致高延遲或拒絕訪問。
4. 需要的具體步驟:購買與建立實例、地域/AZ 選擇、規格與磁碟規劃、系統安裝與遠端連線、VPC 與安全組、OS 防火牆、API 部署(Docker 或 systemd)、Nginx 反代與 TLS、RDS/Redis 建立與連線、性能測試與優化、快照備份/遷移與常見故障排查。
一、架構與實施目標
- 內網優先:API 僅暴露於 VPC 內,對外流量經 NAT 出口;必要時僅開放特定來源的 443/80。
- 三層防護:安全組 + OS 防火牆 + 反向代理存取控制。
- 可回滾:系統與資料庫均有定時備份與手動快照;配置基於檔案並版本化。
- 可運維:systemd 或 Docker 持續運行,標準化日志路徑與健康檢查。
二、雲伺服器購買與建立
1) 地域與可用區
- 選擇距離主要使用者最近的地域;多可用區部署可提升容災。
- 調研延遲:本地對各地域執行 ping/mtr,目標 < 50ms 為佳。
2) 規格建議
- CPU/記憶體:API 型服務常見 2C4G/4C8G 起步;需 TLS 與高併發選 4C8G+。
- 磁碟:系統盤 40–80GB SSD;資料盤視日誌與媒體大小而定。需要穩定 IOPS 選擇高性能雲盤並設定期望 IOPS(若雲商支援)。
- 網卡:選擇與 VPC 子網對應的網卡;帶寬僅內網時可不綁定 EIP(公網 IP)。
3) 建立實例關鍵參數
- VPC/子網:放入目標內網子網,確保與 RDS/Redis 同 VPC 或可路由互通。
- 公網 IP:內網服務建議不分配;如需臨時維運,使用跳板機或臨時綁定 EIP。
- 映像:Linux(Ubuntu 22.04/CentOS 7+/Rocky 8+)或 Windows Server 2019/2022。
- 登入方式:優先 SSH 金鑰;Windows 使用自動產生的管理員密碼。
- 標籤與命名:project=int-api-cfg, env=prod/stage, role=api。
三、系統安裝與遠端連線
1) Linux(SSH)
- 產生金鑰:ssh-keygen -t ed25519 -C your_mail
- 控制台導入公鑰,複製私鑰到維運終端,權限:chmod 600 id_ed25519
- 連線:ssh -i id_ed25519 ubuntu@
- 常見問題:
a. 連不上:確認安全組入站允許 22/TCP;本機出口 22 未被公司防火牆阻擋。
b. Permission denied:檢查用戶名(ubuntu/centos/ec2-user/root)與金鑰權限。
2) Windows(RDP)
- 控制台取得管理員密碼;啟用 3389 入站規則(臨時開放要求來源白名單)。
- 客戶端連線:mstsc,輸入 。
- 完成後建議關閉公網 RDP,改用跳板機或內網堡壘機。
四、安全組與 OS 防火牆
1) 安全組規則
- 入站:
a. SSH 22/TCP:來源限制至辦公出口或堡壘機 SG。
b. RDP 3389/TCP:同上,僅臨時開放。
c. API 內部埠(如 3000/8080):來源限定為同 VPC/子網或負載均衡 SG。
d. HTTPS/443(如需要外部):來源白名單或全網,配合 WAF/速率限制。
- 出站:允許全部或限制到必要目的(NTP、RDS、物件儲存、外部 API)。
2) OS 防火牆
- Ubuntu/Debian:
ufw default deny incoming
ufw allow 22/tcp
ufw allow from to any port 3000 proto tcp
ufw enable
- CentOS/Rocky(firewalld):
firewall-cmd --permanent --add-service=ssh
firewall-cmd --permanent --add-rich-rule='rule family=ipv4 source address= port protocol=tcp port=3000 accept'
firewall-cmd --reload
- Windows:在 Windows 防火牆建立入站規則僅允許特定來源與端口。
五、部署 API 服務
方案 A:Docker 部署
1) 安裝 Docker/Compose(以 Ubuntu 為例)
- apt update && apt install -y ca-certificates curl gnupg
- 安裝官方 repo 並安裝 docker-ce、docker compose plugin
- systemctl enable --now docker
2) 撰寫 compose.yml(示例)
- 內容要點:
services:
api:
image: your.registry/int-api-cfg:1.0.0
ports:
- "127.0.0.1:3000:3000" # 僅本機暴露,由 Nginx 反代
environment:
- NODE_ENV=production
- DB_HOST=10.0.1.10
- DB_USER=app
- DB_PASS=...(改為從檔案或秘密管理服務讀取)
restart: unless-stopped
healthcheck: curl -fsS http://127.0.0.1:3000/health || exit 1
3) 啟動與開機自啟
- docker compose up -d
- 驗證:curl -I http://127.0.0.1:3000/health
方案 B:原生二進制或 Node/Python(systemd)
1) 佈署到 /opt/int-api-cfg,日誌至 /var/log/int-api-cfg
2) 建立環境檔 /etc/int-api-cfg.env
- DB_HOST=10.0.1.10
- DB_USER=app
- DB_PASS=(避免明文,建議注入或使用憑證管理)
3) 建立 systemd 服務 /etc/systemd/system/int-api-cfg.service
- [Unit]
Description=INT API CFG
After=network-online.target
- [Service]
EnvironmentFile=/etc/int-api-cfg.env
ExecStart=/opt/int-api-cfg/bin/api --port 3000
Restart=always
RestartSec=3
User=svcapi
Group=svcapi
LimitNOFILE=65535
- [Install]
WantedBy=multi-user.target
4) 啟動
- systemctl daemon-reload
- systemctl enable --now int-api-cfg
- 驗證:ss -lntp | grep 3000
六、反向代理與 TLS
1) 安裝 Nginx
- apt install -y nginx 或 yum install -y nginx
- 關閉預設站點,開啟自訂站點。
2) 站點配置(/etc/nginx/conf.d/int-api-cfg.conf)
- upstream int_api_backend { server 127.0.0.1:3000; }
- server {
listen 443 ssl http2;
server_name api.internal.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
location / { proxy_pass http://int_api_backend; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }
allow 10.0.0.0/8; deny all; # 僅內網
}
- 內網限定:allow/deny 搭配安全組雙重限制。
3) 憑證
- 公網域名:使用 ACME/Let’s Encrypt(certbot)簽發。
- 內網域名:使用企業私有 CA 或雲私有憑證服務,並在客戶端信任根憑證。
4) 測試與重載
- nginx -t && systemctl reload nginx
- curl -vkI https://api.internal.example.com/health
七、資料庫與快取
1) 建立 RDS MySQL(私網訪問)
- 選擇同 VPC/子網或可路由子網。
- 規格:2C4G 起步,儲存 50–100GB,開啟自動備份(7–30 天)。
- 安全組:允許來源為 API 伺服器 SG 的 3306/TCP 入站。
- 參數:
max_connections:視高併發設定(例如 500–2000)。
sql_mode:避免與框架不相容的嚴格模式(視需求調整)。
2) 建立資料庫與用戶
- 建立 app 資料庫與 app 用戶,限制連線主機為 API 伺服器私網段。
- 權限:僅授權必要 schema 與 DML 權限。
3) 連線測試
- 在 API 伺服器:mysql -h 10.0.2.15 -u app -p -e "select 1"
- 連不上排查:
a. 超時:雙方安全組、路由表、NACL、RDS 白名單。
b. Access denied:用戶來源 host 不匹配或密碼錯誤。
c. DNS 解析到公網:使用私有 DNS 記錄或直連私網 IP。
4) Redis(託管或自建)
- 僅開放私網,設置 requirepass 與 tls(若支援)。
- 參數:
maxmemory-policy=allkeys-lru 或 volatile-lru 視場景;
tcp-keepalive=60;
timeout=0(永不自動斷線,視需求)。
- 測試:redis-cli -h 10.0.2.20 -a ping
5) 連線池建議
- API 端連線池大小:CPU 核數*2 到 *4;
- 設定連線閾值與超時,避免打滿 RDS 最大連線。
八、網絡與 IP 配置
1) 公網/私網策略
- 僅私網:不分配 EIP,出站透過 NAT Gateway;限制出站至必要端點。
- 對外 API:綁定 EIP 至負載均衡,再轉發至 Nginx(建議)。
2) 私有 DNS
- 在私有 DNS 建立 A 記錄:api.internal.example.com -> 10.0.1.5
- 客戶端需使用 VPC 內 DNS 服務器。
3) 延遲測試
- mtr -rwz 10.0.2.15 或 curl -w "time_connect: %{time_connect}\n" https://api...
4) OS 網絡調優(Linux)
- /etc/sysctl.d/99-sysctl.conf:
net.core.somaxconn=4096
net.ipv4.tcp_max_syn_backlog=4096
net.ipv4.ip_local_port_range=10000 65000
net.ipv4.tcp_tw_reuse=1
- sysctl --system
5) 啟用 BBR(若內核支援)
- net.core.default_qdisc=fq
- net.ipv4.tcp_congestion_control=bbr
九、性能測試與優化
1) 壓測工具
- hey、wrk、ab:hey -z 60s -q 100 -c 200 https://api.internal...
2) 監控指標
- CPU/Load、記憶體、磁碟 I/O、網路帶寬、連線數(ss -s)、fd 上限(ulimit -n)。
3) Nginx 調整
- worker_processes auto;worker_connections 4096;keepalive_timeout 60。
4) 應用層
- 啟用快取、壓縮(gzip/br)、減少資料庫 round-trip;合理索引。
十、快照備份與回滾
1) 伺服器
- 啟用系統盤自動快照策略(每日/每週),保留 7–30 份。
- 發版前手動建立快照;出故障快速回滾實例或掛載快照盤抽取檔案。
2) RDS
- 啟用自動備份與 binlog;重大更新前建立手動備份。
- 恢復到指定時間點(PITR)演練至少每季一次。
十一、系統重裝與遷移
1) 零停機思路
- 新建同規格實例 -> 同步配置與映像 -> 導流至新實例(切換私有 DNS/負載均衡目標)-> 視情況迴退。
2) 應用資料
- 使用 rsync/rsnapshot 同步;容器映像推送至倉庫,確保可復現。
3) IP 策略
- 使用內部負載均衡或私有 DNS 名稱,避免綁死單一 IP。
十二、常見故障排查清單
1) 端口不通
- 檢查順序:安全組 -> NACL -> 路由表 -> OS 防火牆 -> 進程監聽(ss -lntp)。
2) 502/504
- 後端未啟動或超時;Nginx proxy_read_timeout 調整;查看後端日誌。
3) TLS 錯誤
- 憑證鏈不全或過期;主機名與證書不匹配;伺服器時間偏差(配置 NTP)。
4) 資料庫連線耗盡
- 提升 RDS max_connections;API 連線池限流;查找慢查詢與長事務。
5) 連線抖動
- 檢查 NAT 配置、conntrack 表容量;提高 net.netfilter.nf_conntrack_max(若內核支援)。
6) 高 CPU steal
- 選擇低過賣或專屬型規格;跨 AZ 容災遷移。
7) DNS 解析錯
- 校驗私有 DNS 記錄;應用層禁用硬編碼公網域名。
十三、使用限制與注意事項
- 安全組規則數量有限,透過地址段聚合減少規則數。
- 單實例檔案描述符有上限,需提升 ulimit 與 systemd LimitNOFILE。
- NAT 出口連線數限制,壓測前評估可用連線與 SNAT 端口範圍。
- RDS/Redis 規格非彈性無縫擴容時,升級需停服或使用只讀複本切換。
- 內網證書需確保客戶端信任鏈部署完整。
十四、最佳實踐摘要
- 基礎設施即代碼(IaC)管理 VPC/SG/實例與 RDS 參數,版本化。
- 用秘密管理服務注入敏感參數,不落盤或加密落盤。
- 以私有 DNS 名稱接入內網 API,配合允許清單與 TLS 客戶端驗證(如需要)。
- 部署前後自動化健康檢查與回滾節點;壓測與容量規劃週期化執行。
- 每次變更前建立快照與資料庫手動備份,演練恢復流程。
結語
以上步驟可直接落地到任何主流雲環境。按本指南完成 int-api-cfg 的內網部署後,API 僅在 VPC 內可用,具備 TLS、最小權限、安全組與 OS 防火牆雙重防護、可觀測與可回滾能力,能在出現連線、性能或配置問題時快速定位與修復。

