환경 변수
Hollo는 환경 변수를 통해 여러 가지 설정을 할 수 있습니다.
환경 변수는 프로젝트 최상위 디렉터리에 .env 파일을 만들거나,
Docker의 -e
/--env
옵션을 쓰거나,
Railway의 environment variables 메뉴에서 설정할 수 있습니다.
PORT
선택 Railway에서는 안 쓰임
서버가 수신할 포트 번호. 기본값은 3000입니다.
DATABASE_URL
Railway에서는 안 쓰임
PostgreSQL 데이터베이스의 URL. 예: postgresql://hollo:password@localhost/hollo
.
HOME_URL
선택
설정될 경우, 첫 페이지 접속 시 이 URL로 리다이렉트됩니다. 설정되지 않을 경우, 첫 페이지에서 인스턴스 내 계정 목록이 보입니다.
SECRET_KEY
Railway에서는 안 쓰임
세션을 보호하기 위한 비밀 키. 다음 명령어로 안전한 무작위 비밀 키를 생성 가능합니다:
REMOTE_ACTOR_FETCH_POSTS
선택
원격 액터와 처음으로 조우하게 되었을 때 가져올 최신 공개 게시물의 수.
기본값은 10
입니다.
LOG_LEVEL
선택
애플리케이션의 로그 레벨.
debug
, info
, warning
, error
, fatal
중 택일.
기본값은 info
입니다.
LOG_QUERY
선택
SQL 쿼리를 로그에 남기려면 true
로 설정하세요.
기본값은 false
입니다.
BEHIND_PROXY
선택 Railway에서는 안 쓰임
Hollo가 리버스 프록시 뒤에 있는 경우 true
로 설정하세요.
Hollo가 L7 로드 밸런서 뒤에 위치할 경우 (일반적으로 그래야 합니다), 이 옵션을 켜세요.
기본적으로는 꺼져 있습니다.
ALLOW_PRIVATE_ADDRESS
선택
이 옵션을 true
로 설정하면 서버 측 요청 위조(SSRF) 공격 방지를 풉니다.
로컬 네트워크에서 테스트할 때 이 옵션을 켜야 할 수 있습니다.
기본적으로는 꺼져 있습니다.
S3_REGION
선택
S3 호환 오브젝트 스토리지의 지역. 예: us-east-1
.
몇몇 AWS가 아닌 S3 호환 서비스에서는 이 값이 필요 없을 수 있습니다.
기본값은 auto
입니다.
S3_BUCKET
S3 호환 오브젝트 스토리지의 버킷 이름. 예: hollo
.
S3_URL_BASE
S3 호환 오브젝트 스토리지의 공개 URL 베이스.
예: https://hollo.s3.us-east-1.amazonaws.com
.
S3_ENDPOINT_URL
S3 호환 오브젝트 스토리지의 엔드포인트 URL.
예: https://s3.us-east-1.amazonaws.com
.
S3_FORCE_PATH_STYLE
S3 호환 오브젝트 스토리지에 대해 경로 스타일 URL을 강제할지 여부 (true
혹은 false
).
AWS가 아닌 S3 호환 서비스에서 유용합니다.
기본적으로는 꺼져 있습니다.
AWS_ACCESS_KEY_ID
S3 호환 오브젝트 스토리지 액세스 키.
AWS_SECRET_ACCESS_KEY
S3 호환 오브젝트 스토리지 비밀 키.