zioinfo-mail/workspace/guardia-docs/41_zio서버_DB_연결정보.md
DESKTOP-TKLFCPR\ython cfe2901a55 refactor(structure): consolidate all projects under workspace/
- itsm/    -> workspace/guardia-itsm/
- manager/ -> workspace/guardia-manager/
- app/     -> workspace/guardia-messenger/
- manual/  -> workspace/guardia-docs/

workspace/zioinfo-web/ unchanged.
git mv preserves full commit history.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-31 23:50:56 +09:00

230 lines
5.8 KiB
Markdown

# zio 서버 DB 및 시스템 연결 정보
> **서버**: 101.79.17.164 (zioinfo.co.kr)
> **OS**: Ubuntu 24.04 LTS
> **최종 업데이트**: 2026-05-31
> ⚠️ **보안 주의**: 이 파일은 내부 운영용입니다. 외부 공개 금지.
---
## 1. PostgreSQL 16
| 항목 | 값 |
|------|-----|
| 호스트 | localhost (127.0.0.1) |
| 포트 | 5432 |
| 버전 | 16.11 |
### 데이터베이스 목록
| DB명 | 사용자 | 비밀번호 | 용도 |
|------|--------|---------|------|
| `guardia_db` | `guardia` | `G@urd1a_2026!` | GUARDiA ITSM 메인 DB |
| `gitea_db` | `gitea` | (Gitea 내부 관리) | Gitea 저장소 메타데이터 |
| `zioinfo_db` | `postgres` | (시스템 관리) | 홈페이지 (Spring Boot) |
### pgvector 확장
```sql
-- guardia_db에 설치됨
SELECT extname, extversion FROM pg_extension WHERE extname='vector';
-- vector | 0.6.0
-- 벡터 테이블 목록
\dt tb_vector_*
-- tb_vector_sr, tb_vector_kb, tb_vector_scrap
```
### 연결 방법
```bash
# psql 직접 접속
psql -h localhost -U guardia -d guardia_db
# 비밀번호: G@urd1a_2026!
# Python SQLAlchemy (GUARDiA ITSM)
DATABASE_URL=postgresql+asyncpg://guardia:G%40urd1a_2026%21@localhost:5432/guardia_db
# 주의: @ 문자는 URL 인코딩 시 %40 사용
```
---
## 2. Gitea Git 서버
| 항목 | 값 |
|------|-----|
| URL | http://101.79.17.164:3000 |
| HTTPS | https://zioinfo.co.kr:3000 (도메인) |
| 포트 | 3000 |
### 계정 정보
| 계정 | 비밀번호 | 권한 |
|------|---------|------|
| `zio` | `Zio@Admin2026!` | 관리자 |
### 저장소 목록
| 저장소 | URL | 용도 |
|--------|-----|------|
| `zio/zioinfo-web` | http://localhost:3000/zio/zioinfo-web | 지오정보기술 홈페이지 |
| `zio/guardia-itsm` | http://localhost:3000/zio/guardia-itsm | GUARDiA ITSM |
### Git 원격 연결
```bash
# 인증 포함 URL 형식
https://zio:Zio%40Admin2026%21@zioinfo.co.kr:3000/zio/zioinfo-web.git
http://zio:Zio%40Admin2026%21@101.79.17.164:3000/zio/guardia-itsm.git
```
---
## 3. Ollama (로컬 LLM)
| 항목 | 값 |
|------|-----|
| URL | http://localhost:11434 |
| 포트 | 11434 |
| 바인딩 | 127.0.0.1 (외부 접근 불가) |
### 설치된 모델
```bash
ollama list
# NAME ID SIZE
# llama3:8b ... 4.7 GB
# codellama:7b ... 3.8 GB
# nomic-embed-text ... 274 MB
```
### API 사용
```bash
# 텍스트 생성
curl http://localhost:11434/api/generate \
-d '{"model":"llama3","prompt":"안녕","stream":false}'
# 임베딩 (pgvector 연동)
curl http://localhost:11434/api/embeddings \
-d '{"model":"nomic-embed-text","prompt":"텍스트"}'
```
---
## 4. ChromaDB (벡터 DB)
| 항목 | 값 |
|------|-----|
| 경로 | `/opt/guardia/chroma/` |
| 모드 | 파일 기반 (서버리스) |
| 연동 | Python `chromadb` 라이브러리 |
```python
import chromadb
client = chromadb.PersistentClient(path="/opt/guardia/chroma")
```
---
## 5. 웹 서비스 포트 및 로그인
| 서비스 | 내부 포트 | 외부 URL | 계정 |
|--------|----------|---------|------|
| 홈페이지 | 8082 | https://zioinfo.co.kr | - |
| GUARDiA ITSM | 9001 | https://zioinfo.co.kr:8443 | admin / Admin@2026! |
| GUARDiA Manager | 8002 | https://zioinfo.co.kr:8090 | admin / Admin@zioinfo2026! |
| Gitea | 3000 | https://zioinfo.co.kr:3000 | zio / Zio@Admin2026! |
| Jenkins | 8080 | http://zioinfo.co.kr:8080 | admin / (초기키 확인) |
| Nginx (HTTP) | 80 | http://zioinfo.co.kr | - |
| Nginx (HTTPS) | 443/8443 | https://zioinfo.co.kr | - |
---
## 6. Deploy Webhook (자동 배포)
| 항목 | 값 |
|------|-----|
| 포트 | 9999 |
| 시크릿 | `zioinfo-deploy-2026` |
| 로그 | `/var/log/zioinfo/deploy.log` |
### 배포 흐름
```
git push gitea → Gitea Webhook → http://localhost:9999
→ zioinfo-web: git pull → npm install → npm run build → mvn package → restart
→ guardia-itsm: git pull → pip install → rsync → restart guardia
```
### 수동 배포 트리거
```bash
curl -X POST http://localhost:9999 \
-H "Content-Type: application/json" \
-d '{"repository":{"name":"zioinfo-web"}}'
```
---
## 7. SSH 서버 접속
| 항목 | 값 |
|------|-----|
| 호스트 | 101.79.17.164 |
| 포트 | 22 |
| root 계정 | root / 1q2w3e!Q |
| 키 파일 | `ssh -i "zio-server-key.pem" root@zioinfo.co.kr` |
### 주요 서비스 경로
```bash
/opt/zioinfo/ # 홈페이지 (Spring Boot)
├── app/app.jar # 실행 JAR
└── src/ # 소스 코드
/opt/guardia/ # GUARDiA ITSM
├── app/ # FastAPI 소스
├── venv/ # Python 가상환경
└── chroma/ # ChromaDB 데이터
/opt/manager/ # GUARDiA Manager
├── backend/ # FastAPI 백엔드
└── frontend/ # React 소스
/var/www/
├── zioinfo/ # 홈페이지 정적 파일
└── manager/ # Manager 정적 파일
/var/log/zioinfo/ # 배포·서비스 로그
```
---
## 8. SMTP (이메일)
| 항목 | 값 |
|------|-----|
| 서버 | 101.79.17.164 |
| SMTP 포트 | 25 / 587 |
| IMAP 포트 | 143 / 993 |
| 도메인 | zioinfo.co.kr |
| 계정 | 비밀번호 | 용도 |
|------|---------|------|
| info@zioinfo.co.kr | 1q2w3e!Q | 일반 발신 |
| admin@zioinfo.co.kr | 1q2w3e!Q | 시스템 알림 |
| ythong@zioinfo.co.kr | 1q2w3e!Q | 담당자 |
---
## 9. 서비스 관리 명령어
```bash
# 서비스 상태 확인
systemctl status zioinfo guardia guardia-manager gitea zioinfo-deploy
# 재시작
systemctl restart zioinfo # 홈페이지
systemctl restart guardia # ITSM
systemctl restart guardia-manager # Manager
# 로그 확인
tail -f /var/log/zioinfo/spring.log # 홈페이지
journalctl -u guardia -f # ITSM
tail -f /var/log/zioinfo/deploy.log # 배포 로그
```