# 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   # 배포 로그
```