zenn/sori.studio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

로컬 개발 포트 설정 변경

Browse Source
This commit is contained in:
zenn
2026-06-22 14:29:22 +09:00
parent 06264e9b02
commit 6279a046a9
6 changed files with 28 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
docs/deploy.md
View File

@@ -256,9 +256,9 @@ npm install
# 새로 만들 때는 .env.example을 복사한 뒤 비밀번호를 랜덤 값으로 교체
cp .env.example .env.development
openssl rand -hex 32
# 로컬 DB 컨테이너를 호스트에서 접근할 때는 127.0.0.1:43119 사용
# 로컬 DB 컨테이너를 호스트에서 접근할 때는 127.0.0.1:43082 사용
# 개발 서버 실행 (127.0.0.1:43117)
# 개발 서버 실행 (127.0.0.1:43081)
npm run dev
```
@@ -414,18 +414,18 @@ docker exec sori-studio-db psql -U sori_studio -d sori_studio -c 'SELECT count(*
### 확인 주소
- 개발 서버: http://127.0.0.1:43117
- 관리자: http://127.0.0.1:43117/admin
- Tailwind Viewer: http://127.0.0.1:43117/_tailwind/
- 개발 서버: http://127.0.0.1:43081
- 관리자: http://127.0.0.1:43081/admin
- Tailwind Viewer: http://127.0.0.1:43081/_tailwind/
### 로컬 DB 확인 방법
로컬 개발 DB는 PostgreSQL이며 호스트에서는 `127.0.0.1:43119`로 접근한다. 접속 정보는 Git에 포함하지 않는 `.env.development` 값을 사용한다.
로컬 개발 DB는 PostgreSQL이며 호스트에서는 `127.0.0.1:43082`로 접근한다. 접속 정보는 Git에 포함하지 않는 `.env.development` 값을 사용한다.
| 항목 | 값 |
|------|----|
| Host | `127.0.0.1` |
| Port | `43119` |
| Port | `43082` |
| Database | `.env.development`의 `POSTGRES_DB` |
| User | `.env.development`의 `POSTGRES_USER` |
| Password | `.env.development`의 `POSTGRES_PASSWORD` |
@@ -541,7 +541,7 @@ docker compose --env-file .env.production up -d --build
### 포트
- 로컬 개발: 43117
- 로컬 개발: 43081
- NAS Docker 외부: 43081
- 컨테이너 내부: 3000
- PostgreSQL 외부: 43082
@@ -554,7 +554,7 @@ docker compose --env-file .env.production up -d --build
- 로컬 개발: `.env.development`의 `DATABASE_URL`
- NAS 운영: `.env.production`의 `DATABASE_URL`
- 로컬 개발 예시: `postgres://sori_studio:비밀번호@127.0.0.1:43119/sori_studio`
- 로컬 개발 예시: `postgres://sori_studio:비밀번호@127.0.0.1:43082/sori_studio`
- NAS Docker 예시: `postgres://sori_studio:비밀번호@sori-studio-db:5432/sori_studio`
- `.env.example`에는 실제 비밀번호나 개인 이메일을 기록하지 않음
- 개발/운영 DB 비밀번호와 관리자 비밀번호는 서로 다른 랜덤 값을 사용
@@ -612,7 +612,7 @@ docker compose --env-file .env.production up -d --build
1. `.env.development` 확인.
```bash
# 로컬 개발 DB는 호스트 기준 127.0.0.1:43119를 사용해야 한다.
# 로컬 개발 DB는 호스트 기준 127.0.0.1:43082를 사용해야 한다.
# DATABASE_URL 전체 값은 공유하지 않는다.
rg -n "^(DATABASE_URL|POSTGRES_DB|POSTGRES_USER|DB_PORT)=" .env.development
```
@@ -620,8 +620,8 @@ rg -n "^(DATABASE_URL|POSTGRES_DB|POSTGRES_USER|DB_PORT)=" .env.development
기준:
- `DATABASE_URL` 호스트가 `127.0.0.1`
- `DATABASE_URL` 포트가 `43119`
- `DB_PORT=43119`
- `DATABASE_URL` 포트가 `43082`
- `DB_PORT=43082`
- 운영 NAS 호스트명, 운영 IP, 운영 DB 이름이 포함되지 않음
2. `.env.production` 확인.
@@ -635,7 +635,7 @@ test -f .env.production && rg -n "^(DATABASE_URL|POSTGRES_DB|POSTGRES_USER|APP_P
기준:
- NAS Docker 내부 실행 기준이면 `DATABASE_URL` 호스트가 `sori-studio-db`
- NAS 외부 DB를 별도 인스턴스로 쓰는 경우에도 로컬 개발 DB(`127.0.0.1:43119`)를 가리키지 않음
- NAS 외부 DB를 별도 인스턴스로 쓰는 경우에도 로컬 개발 DB(`127.0.0.1:43082`)를 가리키지 않음
- `APP_PORT=43081`
- `DB_PORT=43082`
- `MEMBER_SESSION_SECRET`이 비어 있지 않고 `ADMIN_PASSWORD`와 다름
@@ -662,8 +662,8 @@ npm run dev
기준:
- 출력 주소가 `http://127.0.0.1:43117`
- 관리자 API 요청에서 `127.0.0.1:43119` 연결 오류가 발생하지 않음
- 출력 주소가 `http://127.0.0.1:43081`
- 관리자 API 요청에서 `127.0.0.1:43082` 연결 오류가 발생하지 않음
5. 커밋 전 민감 정보 확인.