From 43881e5fd9b020abb9e82ee25b3d5ea30708ef58 Mon Sep 17 00:00:00 2001 From: kjh2064 Date: Sat, 27 Jun 2026 02:05:09 +0900 Subject: [PATCH] docs: align ops guidance with websocket proxy --- CLAUDE.md | 5 +++-- DEPLOYMENT_GUIDE.md | 5 +++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index bd95869..f76c4ec 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -315,7 +315,8 @@ location /taxbaik { proxy_pass http://127.0.0.1:5001; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection $connection_upgrade; + proxy_set_header Connection "Upgrade"; + proxy_cache_bypass $http_upgrade; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; @@ -736,7 +737,7 @@ SELECT * FROM inquiries ORDER BY created_at DESC LIMIT 1; | 앱 시작 안 됨 | `journalctl -u taxbaik -n 50` 로그 확인 | | DB 연결 실패 | 환경 변수 `ConnectionStrings__Default` 확인 (systemd unit file) | | 404 /taxbaik | Nginx 설정 재로드: `sudo nginx -t && sudo systemctl reload nginx` | -| Blazor WebSocket 안 됨 | `/taxbaik/admin` 경로에 Upgrade 헤더 필요 (Nginx 설정 확인) | +| Blazor WebSocket 안 됨 | `/taxbaik` location에 `proxy_http_version 1.1`, `Upgrade`, `Connection "Upgrade"` 헤더가 모두 있는지 확인 | | 배포 후 503 | 서비스 시작 대기 (startup 시간 ~5초), `systemctl status taxbaik` 확인 | | 로그인 실패 | `admin_users.password_hash`와 bcrypt 해시, `AuthService` 로그, `/api/auth/login` 응답 확인 | diff --git a/DEPLOYMENT_GUIDE.md b/DEPLOYMENT_GUIDE.md index eb8ef3b..4ed4d52 100644 --- a/DEPLOYMENT_GUIDE.md +++ b/DEPLOYMENT_GUIDE.md @@ -93,7 +93,7 @@ curl -I http://178.104.200.7/taxbaik/admin/login # 로그인 API 확인 curl -X POST http://178.104.200.7/taxbaik/api/auth/login \ -H "Content-Type: application/json" \ - -d '{"username":"admin","password":"admin123"}' + -d "{\"username\":\"admin\",\"password\":\"\"}" # 문의 폼 제출 테스트 curl -X POST http://178.104.200.7/taxbaik/contact \ @@ -161,6 +161,7 @@ journalctl -u taxbaik -f | 증상 | 원인 | 해결 | |------|------|------| | 404 /taxbaik | Nginx 설정 미적용 | `sudo nginx -t && sudo systemctl reload nginx` | +| Blazor WebSocket 안 됨 | `/taxbaik` location에 `proxy_http_version 1.1`, `Upgrade`, `Connection \"Upgrade\"` 헤더가 모두 있는지 확인 | | DB 연결 오류 | 환경 변수 미설정 | systemd service 파일의 ConnectionStrings__Default 확인 | | 503 Service Unavailable | 앱 미시작 | `sudo systemctl restart taxbaik` | | 마이그레이션 실패 | DB 권한 문제 | `GRANT ALL PRIVILEGES ON DATABASE taxbaikdb TO taxbaik;` | @@ -170,7 +171,7 @@ journalctl -u taxbaik -f ### 관리자 계정 - **username**: `admin` -- **password**: `admin123` (bcrypt 해시됨) +- **password**: `` (운영 검증용 비밀번호, Secrets로 관리) - 초기 로그인 후 비밀번호 즉시 변경 권장 ### 블로그 포스트