═══════════════════════════════════════════════════════════════════════ API 인벤토리 등록 가이드 (for Claude/LLM) ═══════════════════════════════════════════════════════════════════════ KimDB: http://192.168.45.253:40000 컬렉션: api_services (서비스), api_endpoints (엔드포인트) [1. 서비스 등록] curl -X POST http://192.168.45.253:40000/api/c/api_services \ -H "Content-Type: application/json" \ -d '{"data": {"id": "my-service", "name": "My Service", "port": 3000, "base_url": "https://my.dclub.kr", "description": "설명", "category": "infra|user|data", "status": "active"}}' [2. 엔드포인트 등록] curl -X POST http://192.168.45.253:40000/api/c/api_endpoints \ -H "Content-Type: application/json" \ -d '{"data": {"service_id": "my-service", "method": "GET|POST", "path": "/api/endpoint", "desc": "설명", "level": 2, "tags": ["tag1"]}}' [3. 조회] curl http://192.168.45.253:40000/api/c/api_services curl http://192.168.45.253:40000/api/c/api_endpoints [4. 인증] X-API-Key: dclub-api-key-2025-secure 대시보드: https://million.dclub.kr ═══════════════════════════════════════════════════════════════════════
← 뒤로

DNS Manager API Hub

총 215개 API REST 143 SDK 72 ...

Categories

Quick Actions Deploy (4) Subdomain (3) Nginx (7) Kim-Nginx (7) PM2 (13) Kim-Expose (10) Guardian (9) Port (6) System (7) Backup (5) Split Deploy (4) SSH Proxy (3) SSH Exec (3) Webhook (6) History (5) Alert (4) V2 External (11) Admin (6)

NexusSSH

Core (5) System (8) PM2 (2) Service (4) Logs (2) Files (3)

SSH Hub

Storage (10) Security (4) API Keys (4) Monitor (6) Report (3) Disk Expert (5) NEW AI API (4)

Citizen v8

Citizen (15)

SDK 메서드

NexusSSH SDK (50) NSE Engine (22)

253 서버

Claude Push (3) kim-gogs (11)
--%
가용성
--
전체
--
정상
--
장애
--
숨김
--

서비스 상태 모니터링

로딩 중...

Claude Code 빠른 시작

세계 어디서나 API Key로 도메인 생성/삭제 가능

도메인 생성 (내부 서버)
curl -X POST https://api.dclub.kr/v2/deploy \
  -H "X-API-Key: dclub-api-key-2025-secure" \
  -H "Content-Type: application/json" \
  -d '{"name":"myapp","server":"253"}'
외부 HTTPS 프록시 (SNI 자동)
curl -X POST https://api.dclub.kr/v2/deploy \
  -H "X-API-Key: dclub-api-key-2025-secure" \
  -H "Content-Type: application/json" \
  -d '{"name":"proxy","backend":"https://api.openai.com"}'
도메인 삭제
curl -X DELETE https://api.dclub.kr/v2/deploy/myapp \
  -H "X-API-Key: dclub-api-key-2025-secure"
상태 확인
curl "https://api.dclub.kr/v2/list?key=dclub-api-key-2025-secure"
curl "https://api.dclub.kr/v2/status/myapp?key=dclub-api-key-2025-secure"
V2 API 파라미터
name서브도메인 (myapp → myapp.dclub.kr)
server내부 서버 (253, 73) - 기본값 253
port포트 지정 (미지정시 자동할당)
backend외부 HTTPS URL (지정시 server/port 무시)

API 추가 정책 (for Claude)

1. 등록 위치
KimDB + api-hub.html
2. 등록 주체
Claude 자동
3. 필수 필드
service_id, method, path, desc, level, tags
상세 가이드 (curl로 확인)
curl https://dns.dclub.kr/api-guide
KimDB: http://192.168.45.253:40000
컬렉션: api_services, api_endpoints
대시보드: million.dclub.kr (인벤토리 탭)

Quick Actions

API Scan

자동 조사

Nginx Status

상태확인

Nginx Reload

리로드

Nginx Restart

재시작

PM2 List

프로세스

System

시스템

Production Status

🛡️ Rate Limiting

-
버킷
-
차단 IP
-
총 요청

⚡ Circuit Breaker

-
서비스
-
정상
-
차단
상세 대시보드 열기 →

Deploy API - 원클릭 배포

POST/api/deploy원클릭 배포 (DNS+Nginx+SSL)
POST/api/deploy/undeploy배포 해제
GET/api/deploy/status배포 상태 조회
DELETE/api/deploy/:subdomain배포 삭제internal

Subdomain API - 서브도메인 관리 (웹 UI)

POST/api/create서브도메인 생성
GET/api/list도메인 목록 조회
POST/api/delete서브도메인 삭제

Nginx API - 웹서버 관리

GET/api/nginx/statusNginx 상태 확인
POST/api/nginx/test설정 문법 테스트 (nginx -t)
POST/api/nginx/reloadNginx 리로드
POST/api/nginx/restartNginx 재시작 (SSL 문제 해결)
GET/api/nginx/sites사이트 목록 조회internal
POST/api/nginx/site사이트 생성internal
DELETE/api/nginx/site/:domain사이트 삭제internal

Kim-Nginx API - C++ 리버스 프록시 (v1.8)

110개 테넌트, 멀티워커, SSL/SNI 지원

GET/api/kim-nginx/status상태 확인 (running/stopped, PID, workers)
GET/api/kim-nginx/tenants테넌트 목록 (110개)
POST/api/kim-nginx/tenant테넌트 추가admin
DELETE/api/kim-nginx/tenant/:domain테넌트 삭제admin
GET/api/kim-nginx/logs로그 조회 (?lines=50&type=error)
POST/api/kim-nginx/reload리로드 (SIGHUP)admin
POST/api/kim-nginx/restart전체 재시작admin

PM2 API - 프로세스 관리

GET/api/pm2/list로컬 PM2 프로세스 목록
POST/api/pm2/restart/:name프로세스 재시작
POST/api/pm2/stop/:name프로세스 중지
POST/api/pm2/start/:name프로세스 시작
POST/api/pm2/restart-all모든 프로세스 재시작
GET/api/pm2/remote/:server/list원격 서버 PM2 목록internal
POST/api/pm2/remote/:server/restart원격 프로세스 재시작internal
POST/api/pm2/remote/:server/stop원격 프로세스 중지internal
GET/api/pm2/all모든 서버 PM2 통합 조회
GET/api/pm2/summaryPM2 요약 통계
POST/api/pm2/restart-everywhere/:name모든 서버에서 앱 재시작
GET/api/pm2/logs/:namePM2 로그 조회
GET/api/pm2/logs-error/:name에러 로그만 조회

Kim-Expose API - Cloudflare Tunnel 스타일 (50500)

대시보드: https://expose.dclub.kr

GEThttps://expose.dclub.kr/health헬스체크
GEThttps://expose.dclub.kr/api/tunnels활성 터널 목록
GEThttps://expose.dclub.kr/api/stats터널 통계
DELETEhttps://expose.dclub.kr/api/tunnels/:name터널 강제 종료
GEThttps://expose.dclub.kr/api/domains전체 도메인 목록 (129개)
POSThttps://expose.dclub.kr/api/deploy도메인 배포 (DNS+Nginx+SSL)
DELETEhttps://expose.dclub.kr/api/domains/:domain도메인 삭제
GEThttps://expose.dclub.kr/api/domains/:domain/status도메인 상태 확인
GEThttps://expose.dclub.kr/api/history배포 히스토리
POSThttps://expose.dclub.kr/api/rollback롤백

AutoOps Guardian API - 자동 모니터링

GEThttp://localhost:50301/healthGuardian API 헬스체크
GEThttp://localhost:50301/api/statusGuardian 실행 상태 및 업타임
GEThttp://localhost:50301/api/pm2PM2 프로세스 목록 (26개)
GEThttp://localhost:50301/api/issues발견된 문제 (Critical/Warning)
GEThttp://localhost:50301/api/logsGuardian 로그 조회 (limit, level)
GEThttp://localhost:50301/api/stats통계 요약 (PM2 + 시스템)
GEThttp://localhost:50301/api/reports/completev1.0 완성 보고서 (JSON/MD)
GEThttp://localhost:50301/api/reports/improvementv1.1 개선 보고서 (5분 체크)
GEThttp://localhost:50301/api/reports/readmeREADME 사용 설명서
GEThttp://192.168.45.232:50301/health[232 서버] Guardian API 헬스체크
GEThttp://192.168.45.232:50301/api/status[232 서버] Guardian 상태 조회
GEThttp://192.168.45.232:50301/api/pm2[232 서버] PM2 프로세스 목록
GEThttp://192.168.45.232:50301/api/logs[232 서버] Guardian 로그 (최근 100줄)
GEThttp://192.168.45.232:50301/api/issues[232 서버] 발견된 이슈 목록

Million AI - 500만 AI 클론 시뮬레이션 (232 서버)

GET/api/email/healthEmail API 헬스체크
GET/api/email/stats전체 통계 (users/emails/posts)
GET/api/email/throughput초당 처리량
GET/api/email/report일일/주간 보고서 (?period=daily|weekly)
GET/api/email/recent최근 이메일 조회 (?limit=20)
GET/api/email/live실시간 활동 (분당)
GET/api/email/emails/stats이메일 통계 (전체/활성/초당)
GET/api/email/search이메일 검색 (?q=keyword&limit=20)
GET/api/email/sent/:userId발신 이메일 조회
GET/api/email/received/:userId수신 이메일 조회

Million AI Dashboard - 실시간 대시보드

GEThttp://ai-million.dclub.kr메인 대시보드 (실시간 통계)
GEThttp://192.168.45.73:300000/healthDashboard API 헬스체크
GEThttp://192.168.45.73:300000/api/stats/total전체 통계 (사용자/이메일)
GEThttp://192.168.45.73:300000/api/stats/growth성장률 통계 (30일)
GEThttp://192.168.45.73:300000/api/stats/email/hourly시간대별 이메일 추이
GEThttp://192.168.45.73:300000/api/stats/top/senders발신 Top 10
GEThttp://192.168.45.73:300000/api/stats/top/receivers수신 Top 10

Port API - 포트 관리

GET/api/port/list등록된 포트 목록
GET/api/port/next다음 사용 가능 포트
POST/api/port/reserve포트 예약
DELETE/api/port/release/:server/:port포트 해제
GET/api/port/find포트로 앱 찾기
GET/api/port/health포트 헬스체크

System API - 시스템 정보

GET/api/system/status시스템 상태 (CPU, 메모리, 디스크)
GET/api/system/all전체 시스템 정보
GET/api/system/processes프로세스 목록
GET/api/system/ports열린 포트 목록
GET/api/system/remote원격 서버 정보
GET/api/system/pm2-remote원격 PM2 정보
GET/api/system/health-all모든 서비스 상태 통합 조회

Backup API - 백업 관리

GET/api/backup/list백업 파일 목록internal
POST/api/backup/create수동 백업 생성internal
GET/api/backup/:filename백업 파일 조회internal
POST/api/backup/restore/:filename백업 복원internal
DELETE/api/backup/:filename백업 파일 삭제internal

Split Deploy API - 분할 배포

GET/api/split/list분할 배포 목록internal
POST/api/split/create분할 배포 생성internal
DELETE/api/split/:subdomain분할 배포 삭제internal
POST/api/split/auto자동 분할 배포internal

SSH Proxy API - SSH 프록시

GET/api/ssh-proxySSH 프록시 목록internal
POST/api/ssh-proxySSH 프록시 생성internal
DELETE/api/ssh-proxy/:nameSSH 프록시 삭제internal

SSH Exec API - 원격 명령 실행

GET/api/ssh/serversSSH 대상 서버 목록X-API-Key
POST/api/ssh/exec원격 명령 실행X-API-Key
POST/api/ssh/pm2원격 PM2 명령X-API-Key

SSH Hub Storage API (ssh.dclub.kr:50200)

서버 73, 232, 253 통합 모니터링

GET/api/storage/disk전체 서버 디스크 사용량
GET/api/storage/files/recent최근 수정 파일 목록
GET/api/storage/files/big대용량 파일 목록
GET/api/storage/logs/errors에러 로그 분석
GET/api/storage/logs/auth인증 로그 (SSH 접속)
GET/api/sync/nfsNFS 마운트 상태
GET/api/sync/rsyncRsync 작업 상태
GET/api/security/rootkitRootkit 스캔 결과
POST/api/security/scan바이러스 스캔 실행
POST/api/sync/run수동 동기화 실행

SSH Hub Security API

GET/api/fail2banFail2ban 상태
POST/api/fail2ban/unban/:ipIP 차단 해제
GET/api/logs/failed로그인 실패 로그
GET/api/proxy/status프록시 상태

SSH Hub API Keys

GET/api/keysAPI Key 목록admin
POST/api/keysAPI Key 생성admin
POST/api/keys/generate랜덤 Key 생성admin
DELETE/api/keys/:idAPI Key 삭제admin

SSH Hub Report API (NEW)

GET/api/report/daily일일 시스템 보고서 (JSON)
GET/api/report/text텍스트 보고서 (슬랙/텔레그램용)
GET/api/report/weekly주간 PM2 통계 보고서

SSH Hub System Monitor

GET/api/overview전체 서버 개요 (CPU/메모리/디스크)
GET/api/network/connections활성 네트워크 연결
GET/api/process/top상위 프로세스 (CPU/MEM)
GET/api/cron/list예약 작업 목록
GET/api/docker/containersDocker 컨테이너 상태
GET/api/services/status시스템 서비스 상태

SSH Hub Disk Expert API (NEW)

ZFS, SMART, I/O 모니터링 전문 API

GET/api/disk/smart/:deviceSMART 건강 체크 (배드섹터, 온도)
GET/api/disk/zfsZFS 상세 (ARC 캐시, 스냅샷)
GET/api/disk/io디스크 I/O 실시간
GET/api/disk/usage/:path디렉토리 용량 분석
GET/api/files/changed/:minutes최근 N분 내 변경 파일

Webhook API - 웹훅 관리

POST/api/webhook/register웹훅 등록
GET/api/webhook/list등록된 웹훅 목록
GET/api/webhook/history웹훅 실행 히스토리
POST/api/webhook/:projectGogs 웹훅 수신 (배포 실행)
POST/api/webhook/:project/trigger웹훅 수동 트리거
DELETE/api/webhook/:project웹훅 삭제

History API - 배포 히스토리

GET/api/history배포 히스토리 조회
GET/api/history/stats히스토리 통계
GET/api/history/domain/:domain도메인별 히스토리
POST/api/history/log수동 히스토리 기록
POST/api/history/rollback이전 배포로 롤백

Alert API - 알림 시스템

GET/api/alert알림 히스토리 조회
GET/api/alert/recent최근 에러 알림
POST/api/alert/send수동 알림 전송
POST/api/alert/test테스트 알림

V2 External API - 외부 접근용

내부 서버: {name, server} | 외부 HTTPS: {name, backend:"https://..."}

POST/v2/deploy내부 서버 배포X-API-Key
POST/v2/deploy외부 HTTPS 프록시 (SNI)X-API-Key
DELETE/v2/deploy/:name도메인 삭제X-API-Key
GET/v2/status/:name도메인 상태 확인X-API-Key
GET/v2/list도메인 목록X-API-Key
GET/v2/healthV2 API 헬스체크
GET/v2/history배포 히스토리X-API-Key
GET/v2/history/:domain도메인별 히스토리X-API-Key
POST/v2/rollback이전 배포로 롤백X-API-Key
GET/v2/alerts알림 히스토리X-API-Key
GET/v2/health-all전체 서비스 상태X-API-Key

Admin API - 관리

GET/health서버 헬스체크
GET/apiAPI 정보
GET/api/admin/apis등록된 API 목록
POST/api/admin/apis/:actionAPI 활성화/비활성화
GET/api/logs/:servicePM2 로그 조회 (외부용)
GET/api/health/company회사 서비스 전체 상태

NexusSSH API - Core (nexus.dclub.kr:50003)

GET/healthAPI 헬스체크X-API-Key
GET/api/servers서버 프리셋 목록X-API-Key
GET/api/ping/:server서버 PingX-API-Key
POST/api/exec명령 실행X-API-Key
POST/api/exec-all멀티 서버 명령X-API-Key

NexusSSH API - System (8)

GET/api/status/:server시스템 종합 상태X-API-Key
GET/api/status-all전체 서버 상태X-API-Key
GET/api/health/:server헬스체크 (임계치)X-API-Key
GET/api/cpu/:serverCPU 사용률X-API-Key
GET/api/memory/:server메모리 사용량X-API-Key
GET/api/disk/:server디스크 사용량X-API-Key
GET/api/load/:serverLoad AverageX-API-Key
GET/api/uptime/:serverUptimeX-API-Key

NexusSSH API - PM2 (2)

GET/api/pm2/:serverPM2 목록X-API-Key
POST/api/pm2/:server/restart/:namePM2 재시작X-API-Key

NexusSSH API - Service & Process (4)

GET/api/service/:server/:name서비스 상태X-API-Key
POST/api/service/:server/:name/restart서비스 재시작X-API-Key
GET/api/process/:server/:name프로세스 확인X-API-Key
POST/api/process/:server/:name/kill프로세스 종료X-API-Key

NexusSSH API - Logs (2)

GET/api/logs/:server로그 tailX-API-Key
GET/api/logs/:server/search로그 검색X-API-Key

NexusSSH API - Files (3)

GET/api/file/exists/:server파일 존재 확인X-API-Key
GET/api/file/read/:server파일 읽기X-API-Key
GET/api/file/ls/:server디렉토리 목록X-API-Key

SSH Hub - Storage API (ssh.dclub.kr:50200)

3서버 디스크/파일/로그 통합 관리

GET/api/storage/disk3서버 디스크 현황X-API-Key
GET/api/storage/files/recent최근 변경 파일X-API-Key
GET/api/storage/files/big대용량 파일 (100M+)X-API-Key
GET/api/storage/logs/errors시스템 에러 로그X-API-Key
GET/api/storage/logs/authSSH 실패 로그X-API-Key
GET/api/storage/sync/statusNFS 마운트 상태X-API-Key
GET/api/storage/process/zombie좀비 프로세스X-API-Key
GET/api/cluster/status클러스터 상태 (NexusSSH)X-API-Key

SSH Hub - AI API (토큰 최소화)

AI/LLM용 압축 응답 - 한 줄로 상태 확인

GET/api/ai/status서버 상태 한줄X-API-Key
GET/api/ai/storage스토리지 상태X-API-Key
GET/api/ai/cluster클러스터 요약X-API-Key
GET/api/ai/quick/:cmd빠른 명령 (pm2,disk,mem)X-API-Key

Citizen API v8 - 1억 유저 관리 (citizen.dclub.kr:50005)

GET/v8/citizen/:id시민 조회X-API-Key
POST/v8/citizen/search시민 검색X-API-Key
POST/v8/citizen/bulk벌크 시민 조회X-API-Key
GET/v8/citizen/:id/snsSNS 활동 목록X-API-Key
POST/v8/citizen/:id/sns/postSNS 포스트 작성X-API-Key
GET/v8/citizen/:id/email이메일 목록X-API-Key
POST/v8/citizen/:id/email/send이메일 발송X-API-Key
GET/v8/citizen/:id/activity활동 로그X-API-Key
GET/v8/citizen/:id/activity/stats활동 통계X-API-Key
POST/v8/activity/bulk벌크 활동 기록X-API-Key
GET/v8/citizen/:id/dashboard개인 대시보드X-API-Key
GET/v8/stats/global전체 통계X-API-Key

NexusSSH 내부 API (50개) - SDK 메서드

require('./index') 로 사용하는 JavaScript SDK 메서드

Connection (8)

connect()
close()
ping()
isConnected()
reconnect()
setTimeout()
setRetry()
getConfig()

Execution (8)

run(cmd)
runSudo(cmd)
runBackground(cmd)
runWithTimeout(cmd,ms)
runScript(path)
runMulti(cmds)
shell()
getLastResult()

System Info (10)

getSystemStatus()
getCpuUsage()
getMemUsage()
getDiskUsage(mount)
getLoadAverage()
getUptime()
getHostname()
getOS()
getProcesses()
healthCheck(opts)

Service (6)

getServiceStatus(name)
restartService(name)
stopService(name)
startService(name)
isProcessRunning(name)
killProcess(name,sig)

SFTP (12)

getSFTP()
upload(local,remote)
download(remote,local)
exists(path)
readFile(path)
writeFile(path,data)
mkdir(path)
rmdir(path)
unlink(path)
ls(path)
stat(path)
chmod(path,mode)

Tunnel (6)

forwardIn(rport,lport)
forwardOut(lport,rhost,rport)
getTunnels()
closeTunnel(id)
closeAllTunnels()
onTunnelData(cb)

NSE 엔진 API (22개) - 스트레스 테스트

NexusSSHEngine 클래스 메서드 - 1억 동시접속 시뮬레이션

Population (6)

spawn(count,opts)
behavior(pattern)
distribute(servers)
setProfile(profile)
getStats()
destroy(selector)

Chaos (6)

burst(rps,duration)
surge(start,end,step)
jitter(variance)
dropout(percent)
latency(ms,variance)
chaos(scenario)

Monitor (6)

watch(metrics)
alert(threshold,cb)
report(format)
timeline()
export(path)
dashboard()

Cluster (4)

orchestrate(nodes)
balance(algo)
failover(opts)
scale(factor)

232서버 Report API (http://192.168.45.232:50232)

GET/healthAPI 헬스체크
GET/api/status실시간 시스템 상태 (가동시간, 부하, 메모리, PM2 요약)
GET/api/pm2/processesPM2 프로세스 상세 목록 (상태, CPU, 메모리, 재시작 횟수)
GET/api/pm2/logs/:name특정 PM2 프로세스 로그 조회 (?lines=50)
POST/api/report/generate마크다운 보고서 자동 생성 (시스템+메모리+PM2 프로세스)
GET/api/reports생성된 보고서 목록 조회 (파일명, 크기, 생성일)
GET/api/reports/:filename특정 보고서 내용 조회 (마크다운 텍스트)

Claude Push API (http://192.168.45.253:30025)

Claude가 Gogs 저장소에 파일을 직접 커밋하고 동기화하는 API

GET/healthAPI 헬스체크
GET/api/reposkim-gogs-repos에서 저장소 목록 조회 (owner, name, path)
POST/api/push파일 커밋 후 Gogs 동기화 (session, owner, repo, message, files[])

kim-gogs (https://kim-gogs.dclub.kr)

경량 Git 서버 API - 253서버에서 실행되는 C++ 기반 Git 저장소 관리

GET/healthAPI 헬스체크
GET/api/repos저장소 목록 조회 (id, owner, name, description, private, created_at)
GET/api/repos/:owner/:name저장소 상세 정보 (clone_url_ssh, clone_url_http 포함)
POST/api/repos새 저장소 생성 (name, description, private)
GET/api/repos/:owner/:name/commits커밋 목록 조회 (?branch=master&limit=10)
GET/api/repos/:owner/:name/tree/:ref파일 트리 조회 (name, type, sha, size)
GET/api/repos/:owner/:name/blob/:sha파일 내용 조회 (sha, content, size)
GET/api/keysSSH 키 목록 조회 (id, title, fingerprint, created_at)
POST/api/keysSSH 키 추가 (title, key)
POST/api/users사용자 생성 (username, password) - 토큰 자동 발급
POST/api/tokens인증 토큰 생성 (username, password, name)