EV 충전 플랫폼 초기 백업
This commit is contained in:
root
221
INSTALL_GUIDE.md
Executable file
221
INSTALL_GUIDE.md
Executable file
@@ -0,0 +1,221 @@
|
||||
# EV 충전 플랫폼 — 설치 / 복원 가이드
|
||||
|
||||
## 서버 정보
|
||||
|
||||
| 항목 | 값 |
|
||||
|------|------|
|
||||
| 서버 | debian5825u (192.168.0.126) |
|
||||
| 도메인 | s1.byunc.com (OCPP/대시보드), ecap.byunc.com (프록시) |
|
||||
| 프로젝트 경로 | ~/steve/ev-charging-backend |
|
||||
| Steve 경로 | ~/steve/steve |
|
||||
|
||||
## 포트 구성
|
||||
|
||||
| 서비스 | 포트 | 설명 |
|
||||
|--------|------|------|
|
||||
| FastAPI | 8000 | EV 충전 백엔드 API |
|
||||
| Steve OCPP | 8180 | OCPP 서버 |
|
||||
| PostgreSQL | 5432 | 충전 데이터 DB |
|
||||
| Redis | 6375 | 세션 캐시 |
|
||||
| MariaDB (Steve) | 3307 | Steve DB |
|
||||
| OCPP 프록시 | 9002 | 충전기 WebSocket 프록시 |
|
||||
| 프록시 관리웹 | 9003 | 프록시 관리 패널 |
|
||||
|
||||
## 신규 설치 순서
|
||||
|
||||
### 1. 코드 가져오기
|
||||
|
||||
```bash
|
||||
cd ~/steve
|
||||
git clone https://gitea.byunc.com/byun/ev-charging-backend.git
|
||||
cd ev-charging-backend
|
||||
```
|
||||
|
||||
### 2. 환경변수 설정
|
||||
|
||||
```bash
|
||||
cp .env.example .env
|
||||
nano .env
|
||||
```
|
||||
|
||||
수정할 항목:
|
||||
- `POSTGRES_PASSWORD` — DB 비밀번호
|
||||
- `REDIS_PORT=6375`
|
||||
- `STEVE_API_PASSWORD=1234`
|
||||
- `JWT_SECRET` — 랜덤 문자열로 변경
|
||||
- 토스페이먼츠 키 (있으면)
|
||||
|
||||
### 3. Docker 실행
|
||||
|
||||
```bash
|
||||
docker compose build api
|
||||
docker compose up -d
|
||||
|
||||
# 정상 확인
|
||||
docker compose ps
|
||||
curl http://localhost:8000/health
|
||||
```
|
||||
|
||||
### 4. OCPP 프록시 설치
|
||||
|
||||
```bash
|
||||
pip3 install websockets aiohttp
|
||||
|
||||
# 수동 실행 테스트
|
||||
python3 ocpp_proxy_server.py
|
||||
# Ctrl+C로 종료
|
||||
|
||||
# systemd 서비스 등록
|
||||
sudo nano /etc/systemd/system/ocpp-proxy.service
|
||||
```
|
||||
|
||||
```ini
|
||||
[Unit]
|
||||
Description=OCPP Proxy Server
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
WorkingDirectory=/root/steve/ev-charging-backend
|
||||
ExecStart=/usr/bin/python3 ocpp_proxy_server.py
|
||||
Restart=always
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
```bash
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable ocpp-proxy
|
||||
sudo systemctl start ocpp-proxy
|
||||
sudo systemctl status ocpp-proxy
|
||||
```
|
||||
|
||||
### 5. Nginx 설정 (별도 서버인 경우)
|
||||
|
||||
**s1.byunc.com** — `/api/` → :8000, `/steve/` → :8180, `/dashboard` → :8000
|
||||
|
||||
**ecap.byunc.com** — `/` → :9003 (관리웹), `/api/` → :9003, `/ws/` → :9003, 나머지 → :9002 (프록시)
|
||||
|
||||
### 6. 테스트
|
||||
|
||||
```bash
|
||||
# 전체 충전 흐름 테스트
|
||||
python3 test_flow.py
|
||||
|
||||
# 대시보드 접속
|
||||
# https://s1.byunc.com/dashboard (admin / admin1234)
|
||||
|
||||
# 프록시 관리
|
||||
# https://ecap.byunc.com (admin / admin1234)
|
||||
```
|
||||
|
||||
## 백업 순서
|
||||
|
||||
### 코드 백업 (Gitea)
|
||||
|
||||
```bash
|
||||
cd ~/steve/ev-charging-backend
|
||||
git add .
|
||||
git commit -m "백업 메모"
|
||||
git push
|
||||
```
|
||||
|
||||
### DB 백업
|
||||
|
||||
```bash
|
||||
# PostgreSQL 덤프
|
||||
docker exec ev-postgres pg_dump -U evuser ev_charging > backup_db_$(date +%Y%m%d).sql
|
||||
|
||||
# Steve MariaDB 덤프
|
||||
docker exec steve-db-1 mariadb-dump -u root -p<비밀번호> stevedb > backup_steve_$(date +%Y%m%d).sql
|
||||
```
|
||||
|
||||
### 설정 파일 백업 (Git에 포함 안 되는 것들)
|
||||
|
||||
```bash
|
||||
# 한번에 묶기
|
||||
tar czf backup_configs_$(date +%Y%m%d).tar.gz .env proxy_users.json proxy_config.json
|
||||
```
|
||||
|
||||
## 복원 순서
|
||||
|
||||
### 1. 코드 복원
|
||||
|
||||
```bash
|
||||
cd ~/steve
|
||||
git clone https://gitea.byunc.com/byun/ev-charging-backend.git
|
||||
cd ev-charging-backend
|
||||
```
|
||||
|
||||
### 2. 설정 복원
|
||||
|
||||
```bash
|
||||
# .env 파일 복원 (백업에서 복사 또는 .env.example에서 재작성)
|
||||
cp .env.example .env
|
||||
nano .env
|
||||
|
||||
# 프록시 설정 복원 (있으면)
|
||||
# proxy_users.json, proxy_config.json 복사
|
||||
```
|
||||
|
||||
### 3. Docker 실행
|
||||
|
||||
```bash
|
||||
docker compose build api
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### 4. DB 복원 (백업 파일이 있는 경우)
|
||||
|
||||
```bash
|
||||
# PostgreSQL
|
||||
cat backup_db_20260418.sql | docker exec -i ev-postgres psql -U evuser ev_charging
|
||||
|
||||
# Steve MariaDB
|
||||
cat backup_steve_20260418.sql | docker exec -i steve-db-1 mariadb -u root -p<비밀번호> stevedb
|
||||
```
|
||||
|
||||
### 5. 프록시 서비스 시작
|
||||
|
||||
```bash
|
||||
sudo systemctl start ocpp-proxy
|
||||
```
|
||||
|
||||
## 문제 해결
|
||||
|
||||
| 증상 | 확인 | 해결 |
|
||||
|------|------|------|
|
||||
| API 502 | `docker compose ps` | `docker compose up -d` |
|
||||
| 프록시 실패 | `sudo journalctl -u ocpp-proxy -n 20` | 포트 충돌 확인 `ss -tlnp` |
|
||||
| 대시보드 500 | `docker compose logs api --tail 20` | `docker compose restart api` |
|
||||
| bcrypt 에러 | requirements.txt 확인 | `bcrypt==4.0.1` 확인 후 `docker compose build api` |
|
||||
| 포트 충돌 | `ss -tlnp \| grep 포트` | `sudo kill $(lsof -t -i:포트)` |
|
||||
| DB 연결 실패 | `docker compose logs postgres` | `.env`의 비밀번호 확인 |
|
||||
|
||||
## 주요 파일 구조
|
||||
|
||||
```
|
||||
ev-charging-backend/
|
||||
├── docker-compose.yml ← Docker 서비스 정의
|
||||
├── Dockerfile ← FastAPI 이미지
|
||||
├── requirements.txt ← Python 패키지
|
||||
├── .env ← 환경변수 (Git 제외)
|
||||
├── .gitignore
|
||||
├── app/ ← FastAPI 백엔드 코드
|
||||
│ ├── main.py
|
||||
│ ├── config.py
|
||||
│ ├── database.py
|
||||
│ ├── models/
|
||||
│ ├── schemas/
|
||||
│ ├── routers/
|
||||
│ └── services/
|
||||
├── dashboard.html ← 관리 대시보드
|
||||
├── simulator.html ← 충전 시뮬레이터
|
||||
├── ocpp_proxy_server.py ← OCPP 프록시 (Docker 외부)
|
||||
├── proxy_control.html ← 프록시 관리 UI
|
||||
├── test_flow.py ← CLI 테스트 스크립트
|
||||
├── ev_simulator.py ← GUI 테스트 도구
|
||||
├── nginx_fastapi.conf ← Nginx 설정 참고
|
||||
└── README.md
|
||||
```
|
||||
Reference in New Issue
Block a user