📡 API 문서
외부에서 API 호출 시 X-API-Key: dclub-api-key-2025-secure 헤더 필요
🌐 DNS 관리 API
| 메서드 |
엔드포인트 |
설명 |
| GET |
/api/list |
DNS 레코드 목록 |
| POST |
/api/create |
서브도메인 생성 |
| POST |
/api/delete |
DNS 레코드 삭제 |
# 서브도메인 생성
curl -X POST https://api.dclub.kr/api/create \
-H "X-API-Key: dclub-api-key-2025-secure" \
-H "Content-Type: application/json" \
-d '{"subdomain":"myapp","server":"253"}'
# DNS 목록 조회
curl -H "X-API-Key: dclub-api-key-2025-secure" https://api.dclub.kr/api/list
🔧 Nginx 관리 API
| 메서드 |
엔드포인트 |
설명 |
| GET |
/api/nginx/sites |
Nginx 사이트 목록 |
| POST |
/api/nginx/site |
Nginx 사이트 생성 (SSL 자동적용) |
| POST |
/api/nginx/location |
location 블록 추가 (/api 등) |
| DELETE |
/api/nginx/site/:domain |
Nginx 사이트 삭제 |
# Nginx 사이트 생성 (253서버 35000포트로 프록시)
curl -X POST https://api.dclub.kr/api/nginx/site \
-H "X-API-Key: dclub-api-key-2025-secure" \
-H "Content-Type: application/json" \
-d '{"domain":"myapp.dclub.kr","target":"192.168.45.253","port":35000}'
# /api 경로 추가
curl -X POST https://api.dclub.kr/api/nginx/location \
-H "X-API-Key: dclub-api-key-2025-secure" \
-H "Content-Type: application/json" \
-d '{"domain":"myapp.dclub.kr","location":"/api","target":"192.168.45.253","port":35001}'
🌐 External Domain API
Token auth: X-Nginx-Token: kimtunnel-secret-2024
| Method | Endpoint | Description |
|---|
| POST |
/api/nginx/config |
Create nginx config (external domain) |
| GET |
/api/nginx/config/:name |
Get config content |
| DELETE |
/api/nginx/config/:name |
Delete config |
# External domain (mysite.com -> 253:3000)
curl -X POST https://api.dclub.kr/api/nginx/config \
-H "X-Nginx-Token: kimtunnel-secret-2024" \
-H "Content-Type: application/json" \
-d '{"name":"mysite","subdomain":"mysite.com","target":"192.168.45.253:3000","ssl":true}'
# With websocket support
curl -X POST https://api.dclub.kr/api/nginx/config \
-H "X-Nginx-Token: kimtunnel-secret-2024" \
-H "Content-Type: application/json" \
-d '{"name":"myws","subdomain":"ws.mysite.com","target":"192.168.45.253:8080","ssl":true,"websocket":true}'
🚇 Tunnel API
Internal only (192.168.x.x)
| Method | Endpoint | Description |
|---|
| GET |
/api/tunnel/list |
List active tunnels |
| POST |
/api/tunnel/register-key |
Register agent key |
| POST |
/api/tunnel/:id/connect |
Connect domain to tunnel |
| DELETE |
/api/tunnel/:id |
Delete tunnel |
| GET |
/api/tunnel/health |
Tunnel server health |
# Register tunnel agent key
curl -X POST http://127.0.0.1:50000/api/tunnel/register-key \
-H "Content-Type: application/json" \
-d '{"name":"my-laptop","key":"secret-key-123"}'
# Connect tunnel to subdomain
curl -X POST http://127.0.0.1:50000/api/tunnel/abc123/connect \
-H "Content-Type: application/json" \
-d '{"subdomain":"mytunnel","ssl":true}'
🔌 Stream API (TCP/UDP)
Port forwarding via nginx stream
| Method | Endpoint | Description |
|---|
| POST |
/api/nginx/add-stream |
Add TCP/UDP port forward |
# Forward port 3306 to 253 (MySQL)
curl -X POST http://127.0.0.1:50000/api/nginx/add-stream \
-H "Content-Type: application/json" \
-d '{"listen_port":3306,"proxy_pass":"192.168.45.253:3306","description":"MySQL"}'
# Forward port 6379 to 253 (Redis)
curl -X POST http://127.0.0.1:50000/api/nginx/add-stream \
-H "Content-Type: application/json" \
-d '{"listen_port":6379,"proxy_pass":"192.168.45.253:6379","description":"Redis"}'
🔒 SSL 인증서 API
| 메서드 |
엔드포인트 |
설명 |
| GET |
/api/ssl/status/:domain |
SSL 상태 확인 |
| POST |
/api/ssl/apply |
와일드카드 SSL 적용 |
# SSL 적용 (*.dclub.kr 와일드카드 자동 적용)
curl -X POST https://api.dclub.kr/api/ssl/apply \
-H "X-API-Key: dclub-api-key-2025-secure" \
-H "Content-Type: application/json" \
-d '{"domain":"myapp.dclub.kr"}'
⚡ PM2 프로세스 관리 API
| 메서드 |
엔드포인트 |
설명 |
| GET |
/api/pm2/list?server=253 |
PM2 프로세스 목록 |
| POST |
/api/pm2/restart/:name |
프로세스 재시작 |
| POST |
/api/pm2/stop/:name |
프로세스 중지 |
| POST |
/api/pm2/start/:name |
프로세스 시작 |
# PM2 목록 (253서버)
curl "http://127.0.0.1:50000/api/pm2/list?server=253"
# 프로세스 재시작
curl -X POST "http://127.0.0.1:50000/api/pm2/restart/myapp?server=253"
🔌 포트 관리 API
| 메서드 |
엔드포인트 |
설명 |
| GET |
/api/port/list |
전체 포트 목록 |
| GET |
/api/port/next?server=253&range=web |
다음 사용 가능 포트 |
| POST |
/api/port/reserve |
포트 예약 |
| DELETE |
/api/port/release/:server/:port |
포트 해제 |
| GET |
/api/port/find?project=xxx |
프로젝트로 포트 검색 |
# 다음 웹 포트 조회
curl -H "X-API-Key: dclub-api-key-2025-secure" \
"https://api.dclub.kr/api/port/next?server=253&range=web"
# 포트 예약
curl -X POST https://api.dclub.kr/api/port/reserve \
-H "X-API-Key: dclub-api-key-2025-secure" \
-H "Content-Type: application/json" \
-d '{"server":"253","port":30005,"project":"myapp","desc":"내 앱"}'
# 포트 해제
curl -X DELETE -H "X-API-Key: dclub-api-key-2025-secure" \
https://api.dclub.kr/api/port/release/253/30005
📊 포트 범위 규칙
web
30000-39999 (웹 앱)
api
40000-49999 (API 서버)
system
50000-59999 (시스템)
chatbot
53000-53999 (챗봇)
🚀 원클릭 배포 API (★ 추천)
POST /api/deploy
한번의 API 호출로 포트예약 + DNS + Nginx + SSL 전체 자동 설정!
| 파라미터 |
필수 |
설명 |
| subdomain |
필수 |
서브도메인 (예: myapp) |
| port |
필수 |
메인 포트 번호 |
| project |
필수 |
프로젝트명 |
| server |
선택 |
서버 (기본: 253) |
| desc |
선택 |
설명 |
| apiPort |
선택 |
API 서버 포트 (있으면 /api 경로 추가) |
| apiLocation |
선택 |
API 경로 (기본: /api) |
# ⭐ 원클릭 배포 (웹만)
curl -X POST https://api.dclub.kr/api/deploy \
-H "X-API-Key: dclub-api-key-2025-secure" \
-H "Content-Type: application/json" \
-d '{
"subdomain": "myapp",
"port": 35000,
"project": "myapp",
"desc": "내 앱"
}'
# ⭐ 원클릭 배포 (웹 + API)
curl -X POST https://api.dclub.kr/api/deploy \
-H "X-API-Key: dclub-api-key-2025-secure" \
-H "Content-Type: application/json" \
-d '{
"subdomain": "myapp",
"port": 35000,
"project": "myapp",
"desc": "내 앱",
"apiPort": 35001,
"apiLocation": "/api"
}'
# 응답 예시
{
"success": true,
"domain": "myapp.dclub.kr",
"url": "https://myapp.dclub.kr",
"message": "배포 완료!",
"steps": [
{"step": "포트예약", "status": "ok", "port": 35000},
{"step": "API포트예약", "status": "ok", "port": 35001},
{"step": "DNS등록", "status": "ok", "record": "myapp.dclub.kr → 192.168.45.253"},
{"step": "Nginx설정", "status": "ok"},
{"step": "SSL적용", "status": "ok", "type": "wildcard"}
]
}