feat: AI 서버 관리 페이지 Phase 1 구현
- 웹 기반 관리 대시보드 추가 (/admin) - 시스템 상태 모니터링 (AI 서버, Ollama, 활성 모델, API 호출) - 모델 관리 기능 (목록 조회, 테스트, 새로고침) - API 키 관리 시스템 (생성, 조회, 삭제) - 반응형 UI/UX 디자인 (모바일 지원) - 테스트 모드 서버 (test_admin.py) 추가 - 보안: API 키 기반 인증, 키 마스킹 - 실시간 업데이트 (30초 자동 새로고침) 구현 파일: - templates/admin.html: 관리 페이지 HTML - static/admin.css: 관리 페이지 스타일 - static/admin.js: 관리 페이지 JavaScript - server/main.py: 관리 API 엔드포인트 추가 - test_admin.py: 맥북프로 테스트용 서버 - README.md: 관리 페이지 문서 업데이트
This commit is contained in:
52
README.md
52
README.md
@@ -319,11 +319,55 @@ curl -s -X POST http://localhost:26000/v1/chat/completions \
|
||||
}'
|
||||
```
|
||||
|
||||
## AI 서버 관리 페이지 (Admin Dashboard)
|
||||
|
||||
AI 서버의 효율적인 관리를 위한 웹 기반 관리 페이지를 제공합니다.
|
||||
|
||||
### 관리 페이지 접근
|
||||
- **URL**: `http://localhost:26000/admin`
|
||||
- **인증**: API 키 기반 (환경변수 `API_KEY` 설정 필요)
|
||||
|
||||
### 주요 기능
|
||||
|
||||
#### Phase 1: 기본 관리 기능 ✅
|
||||
- **시스템 상태 대시보드**: 서버/Ollama/모델 상태 실시간 모니터링
|
||||
- **모델 관리**: 설치된 모델 목록, 활성 모델 현황, 모델별 사용 통계
|
||||
- **API 키 관리**: 키 생성/조회/삭제, 사용량 모니터링
|
||||
|
||||
#### Phase 2: 고급 기능 (계획)
|
||||
- **모델 다운로드/삭제**: Ollama 모델 원격 관리
|
||||
- **실시간 모니터링**: CPU/메모리/GPU 사용률, API 호출 통계
|
||||
- **설정 관리**: 환경변수 편집, Paperless 연동 설정
|
||||
|
||||
#### Phase 3: 보안 강화 (계획)
|
||||
- **인증 시스템**: JWT 기반 로그인, 2FA 지원
|
||||
- **접근 제어**: IP 화이트리스트, 권한 관리
|
||||
- **감사 로그**: 모든 관리 작업 기록 및 추적
|
||||
|
||||
### 보안 고려사항
|
||||
- **API 키 암호화**: AES-256 암호화 저장
|
||||
- **HTTPS 강제**: SSL/TLS 인증서 필수
|
||||
- **접근 로그**: 모든 관리 페이지 접근 기록
|
||||
- **민감 정보 보호**: 로그에서 API 키 자동 마스킹
|
||||
|
||||
### 사용 예시
|
||||
```bash
|
||||
# API 키 설정
|
||||
export API_KEY=your-secure-api-key
|
||||
|
||||
# 서버 실행
|
||||
python -m server.main
|
||||
|
||||
# 관리 페이지 접근
|
||||
curl -H "X-API-Key: your-secure-api-key" http://localhost:26000/admin
|
||||
```
|
||||
|
||||
## 이 저장소 사용 계획
|
||||
|
||||
1) Ollama API를 감싸는 경량 서버(Express 또는 FastAPI) 추가
|
||||
2) 표준화된 엔드포인트(`/v1/chat/completions`, `/v1/completions`) 제공
|
||||
3) 헬스체크/모델 선택/리밋/로깅 옵션 제공
|
||||
1) ✅ Ollama API를 감싸는 경량 서버(FastAPI) 구현 완료
|
||||
2) ✅ 표준화된 엔드포인트(`/v1/chat/completions`, `/v1/completions`) 제공
|
||||
3) ✅ 헬스체크/모델 선택/리밋/로깅 옵션 제공
|
||||
4) 🚧 웹 기반 관리 페이지 구현 중 (Phase 1)
|
||||
|
||||
우선 본 문서로 설치/선택 가이드를 정리했으며, 다음 단계에서 서버 스켈레톤과 샘플 클라이언트를 추가할 예정입니다.
|
||||
우선 본 문서로 설치/선택 가이드를 정리했으며, 현재 관리 페이지와 고급 기능들을 단계적으로 추가하고 있습니다.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user