config: 사이트 도메인·서버 설정을 .env 로 중앙화 + 설치기 자동 종료 복구
- dotenv 도입, src/shared/env.ts 추가 - loadEnv() 가 프로젝트 루트 .env 를 로드 (override=false: 쉘 env 우선) - getSiteBaseUrl() / getManifestUrl() 헬퍼 - 서버/설치기/리소스팩설치기 진입점에서 loadEnv() 호출 - 설치기 두 종의 기본 MANIFEST_URL 을 SITE_BASE_URL 기반으로 변경 (운영 도메인을 한 곳에서만 바꾸면 됨) - .env.example 템플릿 + .gitignore 에 .env 추가 - README / docs/admin-site.md 에 환경변수 표·사용법 추가 - installer/renderer.js: 4단계 완료 후 자동 종료 다시 활성화
This commit is contained in:
@@ -6,11 +6,25 @@
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm start # 기본 포트 3000. 환경변수로 PORT 조정 가능.
|
||||
cp .env.example .env # 처음 한 번만. 운영 도메인이면 SITE_BASE_URL 만 바꾸면 됩니다.
|
||||
npm start # 기본 포트 3000.
|
||||
```
|
||||
|
||||
배포 시에는 시스템 서비스(systemd 등) 로 등록해 두면 됩니다.
|
||||
|
||||
### 환경변수 (`.env`)
|
||||
|
||||
| 키 | 기본값 | 설명 |
|
||||
| --- | --- | --- |
|
||||
| `PORT` | `3000` | Express 서버 listen 포트. |
|
||||
| `HOST` | `127.0.0.1` | 바인드 주소. 외부 노출하려면 `0.0.0.0`. |
|
||||
| `SESSION_SECRET` | dev secret | `/op` 세션 쿠키 서명 키. 운영에서는 반드시 임의값으로 교체. |
|
||||
| `SITE_BASE_URL` | `http://127.0.0.1:3000` | 설치기 두 종이 첫 화면에서 자동으로 채우는 manifest 호스트. 운영 도메인으로 바꿔두면 manifest URL 도 자동으로 따라갑니다. |
|
||||
| `MANIFEST_URL` | — | 특별히 다른 경로를 쓰고 싶을 때만 지정. 비우면 `${SITE_BASE_URL}/manifest.json`. |
|
||||
| `MUSIC_CONCURRENCY` | (자동) | 리소스팩 설치기 yt-dlp 동시 다운로드 수(1~8). |
|
||||
|
||||
`.env` 는 `.gitignore` 로 제외되어 있습니다. 새 환경을 셋업할 때 `.env.example` 을 복사해서 시작하세요. 쉘에서 직접 환경변수를 지정한 경우에는 `.env` 값을 덮어쓰지 않습니다.
|
||||
|
||||
## 도메인 / 경로 구성
|
||||
|
||||
| 경로 | 내용 |
|
||||
|
||||
Reference in New Issue
Block a user