Skip to content

설정 및 환경변수

설치 후 생성된 .env파일을 수정하여 사용자 설정을 변경할 수 있습니다.

Warning

  • True/False는 반드시 문자열로 입력해야 합니다.
  • .env 파일을 수정하면 서버를 재시작해야 정상적으로 적용됩니다.

FastAPI 설정

APP_IS_DEBUG = "False"

SESSION_COOKIE_NAME = "session"
SESSION_SECRET_KEY = "" 

COOKIE_DOMAIN = ""
환경변수 설명 비고
APP_IS_DEBUG 디버그 모드 설정

주의: 활성화하면 서버 오류 발생 시 오류 메시지가 노출됩니다. 개발환경에서만 사용하시길 권장합니다.
Default: False
SESSION_COOKIE_NAME 세션 생성 쿠키 이름 Default: session
SESSION_SECRET_KEY 세션 생성 비밀키, 설치 시 임의의 50자의 문자열이 생성됩니다.

주의: 이 값이 노출되면 세션을 탈취당할 수 있므로 반드시 비밀키를 설정해야 합니다.
임의의 문자열
COOKIE_DOMAIN 쿠키 생성 도메인

www.gnuboard.comgnuboard.com도메인은 서로 다른 도메인으로 인식합니다. 쿠키를 공유하려면 .gnuboard.com 과 같이 입력하세요.
이곳에 입력하지 않으면 www 붙은 도메인과 그렇지 않은 도메인은 쿠키를 공유하지 못하므로 로그인이 풀릴 수 있습니다.

데이터베이스 설정

설치 시 입력된 데이터베이스 정보를 기반으로 자동으로 입력됩니다.

DB_TABLE_PREFIX = "g6_"
DB_ENGINE = ""
DB_USER = ""
DB_PASSWORD = ""
DB_HOST = ""
DB_PORT = ""
DB_NAME = ""
DB_CHARSET = "utf8mb4"

환경변수 설명 비고
DB_TABLE_PREFIX 테이블 접두사 Default: g6_
DB_ENGINE 데이터베이스 엔진 mysql, postgresql, sqlite
DB_USER 데이터베이스 사용자 이름
DB_PASSWORD 데이터베이스 비밀번호
DB_HOST 데이터베이스 호스트
DB_PORT 데이터베이스 포트
DB_NAME 데이터베이스 이름
DB_CHARSET 사용할 문자셋 Default: utf8mb4

Tip

SQLite로 설치하거나 DB_ENGINE값을 sqlite로 설정했다면, 접속정보관련 값은 무시됩니다.
DB_PASSWORD, DB_HOST, DB_PORT, DB_NAME

이메일 발송 설정

메일 발송 기능을 사용하려면 SMTP 서버 정보를 입력해야 합니다.

SMTP_SERVER="localhost"
SMTP_PORT=25
SMTP_USERNAME=""
SMTP_PASSWORD=""
환경변수 설명 비고
SMTP_SERVER SMTP 서버 주소 Default: localhost
SMTP_PORT SMTP 서버 포트 Default: 25
SMTP_USERNAME SMTP 서버 사용자 이름 예) account@your-domain.com
SMTP_PASSWORD SMTP 서버 사용자 비밀번호

네이버 메일 설정

SMTP_SERVER="smtp.naver.com"
SMTP_PORT=465 # 보안 연결(SSL) 필요
SMTP_USERNAME="네이버 로그인 아이디"
SMTP_PASSWORD="네이버 로그인 비밀번호"

테마 설정

ADMIN_THEME = "basic"

IS_RESPONSIVE = "True"
환경변수 설명 비고
ADMIN_THEME 관리자 테마

경로: /admin/templates/{테마}
Default: basic
IS_RESPONSIVE 반응형 여부 Default: True

기본으로 반응형 템플릿만 제공합니다.
적응형일 경우, 모바일 환경에서 /templates/{테마}/mobile 경로의 파일을 우선 탐색합니다.
자세한 내용은 모바일 테마 제작을 참고해주세요.

에디터 이미지 설정

UPLOAD_IMAGE_RESIZE = "False"
UPLOAD_IMAGE_SIZE_LIMIT = 20
UPLOAD_IMAGE_QUALITY = 80

UPLOAD_IMAGE_RESIZE_WIDTH = 1200
UPLOAD_IMAGE_RESIZE_HEIGHT = 2800
환경변수 설명 비고
UPLOAD_IMAGE_RESIZE 이미지 크기변환 여부 Default: False
UPLOAD_IMAGE_SIZE_LIMIT 이미지 업로드 용량 Default: 20
단위 : MB
UPLOAD_IMAGE_QUALITY 이미지 업로드 퀄리티(jpg) Default: 80
범위 : 0 ~ 100
UPLOAD_IMAGE_RESIZE_WIDTH px 이미지 업로드 크기변환 가로 크기
UPLOAD_IMAGE_RESIZETrue 이고 이미지 넓이가 설정된 값보다 크면 크기를 변환합니다.
Default: 1200
단위 : px
UPLOAD_IMAGE_RESIZE_HEIGHT px 이미지 업로드 크기변환 세로 크기 Default: 2800
단위 : px