로컬 개발 포트 설정 변경

2026-06-22 14:29:22 +09:00
parent 06264e9b02
commit 6279a046a9
6 changed files with 28 additions and 23 deletions
--- a/docs/deploy.md
+++ b/docs/deploy.md
@@ -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. 커밋 전 민감 정보 확인.

--- a/docs/spec.md
+++ b/docs/spec.md
@@ -923,15 +923,15 @@ APP_PORT=43081

 - `.env.example`에는 실제 이메일, 비밀번호, 토큰, 운영 서버 주소를 기록하지 않음
 - `.env.development`와 `.env.production`의 DB 비밀번호와 관리자 비밀번호는 서로 다른 랜덤 값을 사용
- 로컬 개발 `DATABASE_URL`은 호스트 기준 `127.0.0.1:43119`를 사용
+- 로컬 개발 `DATABASE_URL`은 호스트 기준 `127.0.0.1:43082`를 사용
 - NAS Docker 내부 `DATABASE_URL`은 서비스명 기준 `sori-studio-db:5432`를 사용
- 로컬 DB 확인은 PostgreSQL 클라이언트에서 `127.0.0.1:43119`로 접속하거나 `docker exec sori-studio-db psql` 명령으로 확인한다.
+- 로컬 DB 확인은 PostgreSQL 클라이언트에서 `127.0.0.1:43082`로 접속하거나 `docker exec sori-studio-db psql` 명령으로 확인한다.

 ### 포트 기준

 | 용도 | 포트 |
 |------|------|
-| 로컬 개발 서버 | 43117 |
+| 로컬 개발 서버 | 43081 |
 | NAS Docker 외부 포트 | 43081 |
 | 컨테이너 내부 포트 | 3000 |
 | PostgreSQL 외부 포트 | 43082 |
--- a/docs/update.md
+++ b/docs/update.md
@@ -1,5 +1,10 @@
 # 업데이트 이력

+## v1.7.3
+
+- 로컬 개발 앱 포트를 `43081`, PostgreSQL 포트를 `43082`로 변경.
+- 개발 환경 URL·DB 연결 문자열·개발 서버·미리보기 명령의 포트 기준을 통일.
+
 ## v1.7.2

 - NAS Docker 외부 앱 포트를 `43081`, PostgreSQL 외부 포트를 `43082`로 변경.
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "sori.studio",
-  "version": "1.7.2",
+  "version": "1.7.3",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sori.studio",
-      "version": "1.7.2",
+      "version": "1.7.3",
      "hasInstallScript": true,
      "dependencies": {
        "@nuxtjs/tailwindcss": "^6.14.0",
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "sori.studio",
-  "version": "1.7.2",
+  "version": "1.7.3",
  "private": true,
  "type": "module",
  "imports": {
@@ -15,7 +15,7 @@
    "lint": "node scripts/check-js-syntax.js",
    "test": "npm run build",
    "verify": "npm run lint && npm run test",
-    "preview": "nuxt preview --dotenv .env.development --host 127.0.0.1 --port 43117",
+    "preview": "nuxt preview --dotenv .env.development --host 127.0.0.1 --port 43081",
    "db:migrate": "node scripts/migrate-database.js migrate",
    "db:migrate:dev": "MIGRATION_ENV=development ENV_FILE=.env.development node scripts/migrate-database.js migrate",
    "db:migrate:dev:status": "MIGRATION_ENV=development ENV_FILE=.env.development node scripts/migrate-database.js status",
--- a/scripts/dev-server.js
+++ b/scripts/dev-server.js
@@ -1,7 +1,7 @@
 import { spawn } from 'node:child_process'

 const host = '127.0.0.1'
-const port = '43117'
+const port = '43081'
 let printedLinks = false
 let nitroReady = false
 let collectedLines = []