설정 및 환경변수¶

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

Warning

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

FastAPI 설정¶

APP_IS_DEBUG = "False"

SESSION_COOKIE_NAME = "session"
SESSION_SECRET_KEY = "" 

COOKIE_DOMAIN = ""

TIME_ZONE = "Asia/Seoul"

환경변수	설명	비고
`APP_IS_DEBUG`	디버그 모드 설정 주의: 활성화하면 서버 오류 발생 시 오류 메시지가 노출됩니다. 개발환경에서만 사용하시길 권장합니다.	Default: `False`
`SESSION_COOKIE_NAME`	세션 생성 쿠키 이름	Default: `session`
`SESSION_SECRET_KEY`	세션 생성 비밀키, 설치 시 임의의 50자의 문자열이 생성됩니다. 주의: 이 값이 노출되면 세션을 탈취당할 수 있므로 반드시 비밀키를 설정해야 합니다.	임의의 문자열
`COOKIE_DOMAIN`	쿠키 생성 도메인 `www.gnuboard.com`과 `gnuboard.com`도메인은 서로 다른 도메인으로 인식합니다. 쿠키를 공유하려면 .gnuboard.com 과 같이 입력하세요. 이곳에 입력하지 않으면 www 붙은 도메인과 그렇지 않은 도메인은 쿠키를 공유하지 못하므로 로그인이 풀릴 수 있습니다.
`TIME_ZONE`	시스템에서 사용할 표준 시간대	Default: `Asia/Seoul`

데이터베이스 설정¶

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

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  # 또는 587
SMTP_USERNAME="계정 아이디"
SMTP_PASSWORD="비밀번호 or 2단계 인증(앱 비밀번호)"

# 다음
SMTP_SERVER="smtp.daum.net"
SMTP_PORT=465
SMTP_USERNAME="계정 아이디"
SMTP_PASSWORD="비밀번호 or 2단계 인증(앱 비밀번호)"

# 카카오
SMTP_SERVER="smtp.kakao.net"
SMTP_PORT=465
SMTP_USERNAME="계정 아이디"
SMTP_PASSWORD="비밀번호 or 2단계 인증(앱 비밀번호)"

# GMail
SMTP_SERVER="smtp.gmail.net"
SMTP_PORT=587  # 또는 465
SMTP_USERNAME="이메일 주소"
SMTP_PASSWORD="2단계 인증(앱 비밀번호)"

테마 설정¶

ADMIN_THEME = "basic"

IS_RESPONSIVE = "True"

USE_TEMPLATE = "True"

환경변수	설명	비고
`ADMIN_THEME`	관리자 테마 경로: `/admin/templates/{테마}`	Default: `basic`
`IS_RESPONSIVE`	반응형 여부	Default: `True` 기본으로 반응형 템플릿만 제공합니다. 적응형일 경우, 모바일 환경에서 `/templates/{테마}/mobile` 경로의 파일을 우선 탐색합니다. 자세한 내용은 모바일 테마 제작을 참고해주세요.
`USE_TEMPLATE`	템플릿 사용 설정	Default: `True` `False` 로 설정하면 웹 페이지(템플릿)를 표시하지 않습니다.

에디터 이미지 설정¶

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_RESIZE` 가 `True` 이고 이미지 넓이가 설정된 값보다 크면 크기를 변환합니다.	Default: `1200` 단위 : `px`
`UPLOAD_IMAGE_RESIZE_HEIGHT`	px 이미지 업로드 크기변환 세로 크기	Default: `2800` 단위 : `px`

API 설정¶

USE_API = "True"

API_VERSION = "v1"

ACCESS_TOKEN_SECRET_KEY = "secretkey"
REFRESH_TOKEN_SECRET_KEY = "secretkey"
ACCESS_TOKEN_EXPIRE_MINUTES = 30

환경변수	설명	비고
`USE_API`	API 사용 설정	Default: `True` `False` 로 설정하면 API요청에 대해 응답하지 않습니다.
`API_VERSION`	API 버전 `api/`경로에 있는 버전 중 적용할 버전을 선택할 수 있습니다.	Default: `v1`
`ACCESS_TOKEN_SECRET_KEY`	JWT Access Token을 생성하지 위한 비밀 키	Default: `secretkey` 보안을 위해 임의의 문자열로 변경이 필요합니다.
`REFRESH_TOKEN_SECRET_KEY`	JWT Refresh Token을 생성하지 위한 비밀 키	Default: `secretkey` 보안을 위해 임의의 문자열로 변경이 필요합니다.
`ACCESS_TOKEN_EXPIRE_MINUTES`	JWT Access Token 만료 시간	Default: `30` 단위 : `분`
`REFRESH_TOKEN_EXPIRE_MINUTES`	JWT Refresh Token 만료 시간	Default: `20160`(14일) 단위 : `분`