🇨🇳 Discourse 공식 설치 가이드 | Discourse 클라우드 플랫폼 설치

[honeymoose]

본 문서는 discourse/docs/INSTALL-cloud.md at main · discourse/discourse · GitHub 페이지의 내용을 번역한 것입니다.

번역 원문은 Discourse 云平台安装 - Discourse - iSharkFly 에 게시되었습니다. 토론에 참여해 주세요.

클라우드 플랫폼 설치

클라우드 기반 플랫폼에서의 Discourse 설치에는 보통 30분이 채 걸리지 않습니다. Rails나 Linux 셸에 대한 지식이 전혀 없어도 설치를顺利完成할 수 있습니다. 아래에서는 DigitalOcean 서비스 제공자를 사용하여 설치하는 예를 들었지만, 모든 설치 단계는 Docker와 호환되는 모든 클라우드 컴퓨팅 플랫폼에서 수행할 수 있으며, 로컬 서버에서도 설치가 가능합니다.

30분도 시간이 안 되시나요? Discourse 커뮤니티에 연락하여 설치를 도와달라고 요청할 수 있습니다. Discourse 커뮤니티는 일회성 $150(미국 달러)의 비용을 부과합니다. 이 링크를 클릭하여 서비스를 구매하세요 .

시작 전 준비 사항

도메인

Discourse는 IP 주소로는 작동하지 않습니다. 설치하려면 도메인 또는 서브도메인이 필요합니다. 예를 들어 example.com 등.

• 이미 도메인을 보유하고 있다면, discourse.example.com 또는 talk.example.com 또는 forum.example.com과 같은 서브도메인 중 하나를 선택하여 Discourse 인스턴스를 설치할 수 있습니다.
• 도메인이 없다면, NameCheap 웹사이트를 방문하여 원하는 도메인을 검색하거나, Google에서 great domain name registrars를 검색하여 마음에 드는 도메인 등록사를 선택할 수 있습니다.
• DNS 콘솔에 접근할 수 있어야 합니다. 도메인을 구매한 후에는 DNS 설정에 접근하여 DNS를 구성해야 합니다. 설치하려는 Discourse 웹사이트에 대해 DNS를 통해 A 레코드를 생성해야 합니다. 이 A 레코드는 설치하려는 도메인을 특정 IP 주소로 가리키도록 해야 합니다. 이 IP 주소는 일반적으로 첫 번째 단계에서 구매한 서버의 IP 주소입니다.

이메일

이메일 시스템은 Discourse의 사용자 생성 과정에서 매우 중요합니다. Discourse 설치 전에 이메일 SMTP 서버를 생성하지 않으면, 설치한 Discourse에 접근하거나 로그인할 수 없습니다(사이트가 깨진 상태)!*

• 이미 자체 SMTP 메일 서버가 있다면, 기존 메일 서버 설정 정보를 그대로 사용할 수 있습니다.
• 메일 서버가 없다면, Discourse에서 권장하는 메일 서버를 방문하세요.
• 이메일이 정상적으로 전달되도록 하려면 DNS에 유효한 SPF 및 DKIM 레코드를 추가해야 합니다. 메일 서비스 제공업체의 문서에서 이 정보 설정 방법을 확인하세요.

실제 사용 경험을 바탕으로, Discourse 설치에는 사용 가능한 도메인과 메일 서버 설정이 필수입니다. 중국 본토의 경우, 알리바바 클라우드 또는 텐센트 클라우드에서 제공하는 기업용 메일함을 사용할 수 있습니다. 일반적으로 해외 메일 서버, 예를 들어 AWS SES나 MailGun과 같은 서비스를 사용하는 것을 권장합니다. 국제 신용카드가 필요할 수 있습니다. 이 단계는 필수이며, 그렇지 않으면 Discourse 설치를 완료할 수 없습니다.

중국 본토에서 적절한 SMTP 서버를 찾지 못해 급하게 설치해야 하는 경우, 잘못된 설정을 먼저 사용하여 설치한 후, Discourse 설치 디렉터리에서 콘솔을 통해 수동으로 관리자 계정을 생성할 수 있습니다:

./launcher enter app
rails admin:create

설치

새 클라우드 서버 생성

새로운 클라우드 서버, 예를 들어 DigitalOcean을 생성하세요. 물론 다른 플랫폼에서 제공하는 서버를 사용할 수도 있습니다.

중국 본토 내에 위치한 서버를 선택했다면 네트워크 문제를 겪을 가능성이 높습니다. 이 번역본에는 네트워크 문제 해결을 위한 섹션이 추가로 포함되어 있습니다.

• 기본 구성인 현재 버전의 LTS Ubuntu 운영 체제가 잘 작동합니다. 최소한 64비트 Linux 운영 체제가 필요하며, 이 운영 체제의 커널은 최신 버전으로 업데이트되어 있어야 합니다.
• 기본 구성인 1 GB의 메모리는 작은 규모의 Discourse 커뮤니티에서는 일반적으로 잘 작동합니다. 하지만 대규모 커뮤니티를 위해 2 GB의 메모리를 권장합니다.
• 기본 구성인 뉴욕 데이터 센터는 북미와 유럽 모두에게 좋은 지리적 영역입니다. Discourse 사용자가 다른 지리적 위치에 있는 경우, 조금 더 가까운 데이터 센터를 선택할 수 있습니다.
• DigitalOcean에서 Droplet을 생성하려면 도메인 discourse.example.com을 입력하세요 (Droplet은 DigitalOcean이 정의한 서버 이름입니다). 물론 자체 도메인을 구매하여 사용할 수도 있습니다. 일반적으로 Discourse 설치에는 실제 도메인이 필요하며 IP 주소로는 설치할 수 없으므로, 먼저 도메인을 구매하거나 기존 도메인의 서브도메인을 사용하는 것을 권장합니다.

새로운 Droplet을 생성하는 과정은 DigitalOcean에서 서버를 생성하는 것과 같으며, 다른 플랫폼에서 VPS나 서버를 생성하는 것과도 동일합니다. 생성이 완료되면 Root 사용자 비밀번호가 포함된 이메일을 받게 됩니다. 하지만 서버 접근 보안을 강화하기 위해 SSH 키 사용 설정을 권장합니다.

클라우드 서버에 접근하기

IP 주소를 사용하여 SSH를 통해 생성한 서버에 연결하고 접근하거나, Windows 플랫폼의 경우 Putty를 설치한 후 아래 명령을 실행하여 연결할 수 있습니다:

ssh root@192.168.1.1

SSH 키를 설정하지 않았다면, DigitalOcean에서 보낸 이메일에 포함된 비밀번호로 로그인하거나, 로컬 SSH 키를 사용하여 연결할 수 있습니다.

Docker / Git 설치 (선택 사항)

sudo apt install docker.io
sudo apt install git

자체 Docker 버전을 사용하려면 이제 새로 설정한 서버에 설치할 수 있습니다. 서버에 Docker가 기본적으로 설치되어 있지 않으면 discourse-setup이 get.docker.com에서 자동으로 다운로드하여 설치합니다.

이 단계에서 네트워크 문제가 발생했다면 ubuntu 미러 사이트 사용 도움말 | Tsinghua Open Source Mirror를 시도해 보세요.

Discourse 설치

공식 Discourse Docker 설치 저장소에서 코드를 로컬 컴퓨터의 /var/discourse 디렉터리로 클론합니다.

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse

이 단계에서 네트워크 문제가 발생했다면 다음을 시도해 보세요:

git config --global url."https://mirror.ghproxy.com/https://github.com/".insteadOf "https://github.com/"

위 명령을 실행하기만 하면 됩니다. Discourse 설치 과정에는 root 권한이 필요합니다.

Docker 미러 추가 (중국 본토 서버 전용)

서버가 중국 본토에 위치해 있다면, 아래 단계에서 docker 단계에서 막힐 가능성이 높습니다. Docker 미러를 추가해 보세요.

텐센트 클라우드를 예로 들면, 좋아하는 편집기를 사용하여 linux의 /etc/docker/daemon.json을 편집하고 아래 내용을 추가하세요. https://mirror.ccs.tencentyun.com을 클라우드 서버 제공업체가 제공하는 docker 미러 URL로 변경해 볼 수 있습니다:

{
   "registry-mirrors": [
   "https://mirror.ccs.tencentyun.com"
  ]
}

docker 미러를 추가한 후, sudo systemctl restart docker를 사용하여 docker 애플리케이션을 재시작하여 변경 사항을 적용하세요.

Discourse 설정 편집

아래 명령을 실행하여 설정 도구를 실행합니다.

./discourse-setup

아래 프롬프트에 따라 모든 매개변수를 구성해야 합니다:

Hostname for your Discourse? [discourse.example.com]: 
Email address for admin account(s)? [me@example.com,you@example.com]: 
SMTP server address? [smtp.example.com]: 
SMTP port? [587]: 
SMTP user name? [user@example.com]: 
SMTP password? [pa$word]: 
Let's Encrypt account email? (ENTER to skip) [me@example.com]: 

위 입력 데이터는 Discourse 인스턴스를 위한 app.yml 파일을 생성합니다. 이 파일은 설치 진행 후 Discourse 인스턴스를 구성하는 데 사용됩니다. 전체 설치 시작 과정은 Discourse 구성에 2~8분이 소요될 수 있습니다. 설치 중 오류가 발생하거나 설치 완료 후에도 구성을 수정해야 하는 경우, ./discourse-setup 명령을 다시 실행할 수 있습니다(이 명령은 기존 app.yml 파일을 다시 로드합니다). 또는 /containers/app.yml 파일의 내용을 직접 수동으로 편집한 후 ./launcher rebuild app를 다시 실행할 수도 있습니다. 그렇지 않으면 변경 사항이 적용되지 않습니다.

중국 네트워크 환경 최적화

클라우드 서버가 중국 본토에 위치해 있다면, ./discourse-setup 또는 ./launcher rebuild app를 실행하는 과정에서 네트워크 문제를 겪을 가능성이 높습니다. Discourse는 docker를 제외한 미러 서비스를 이미 작성해 두었으며, containers/app.yml의 여기 한 줄을 추가하기만 하면 됩니다:

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"
  - "templates/web.template.yml"
  - "templates/web.china.template.yml" # 이 줄을 추가하여 npm, rubygems 등 패키지 매니저의 미러를 구성합니다

이렇게 하면 해결됩니다.

Discourse 시작

초기 설치 구성이 완료되면, 구성한 도메인 discourse.example.com을 통해 브라우저에서 Discourse 인스턴스에 접근할 수 있어야 합니다.

중국 본토에 위치한 서버의 경우, 클라우드 서버 제공업체의 안내에 따라 먼저 통지(备案)를 진행해야 다음 단계를 진행할 수 있을 수 있습니다.

새 관리자 계정 등록

시작 구성 과정에서 입력한 이메일 주소를 사용하여 관리자 계정을 등록합니다.

(관리자 계정(Admin)을 등록할 수 없다면, 경로 /var/discourse/shared/standalone/log/rails/production.log를 통해 로그를 확인하거나 이메일 문제 점검 목록을 방문하세요.)

관리자 계정 등록을 완료하면, 설정 마법사가 시작되어 Discourse 인스턴스를 구성하도록 안내합니다.

모든 설정 마법사를 완료하면, 스태프 토픽(Staff topics)과 READ ME FIRST: Admin Quick Start Guide를 볼 수 있습니다. 이 구성 마법사에는 후속 구성에 대한 권장 사항과 Discourse 설치 인스턴스를 사용자 지정하는 방법에 대한 정보가 포함되어 있습니다.

설치 후 유지 관리

• 운영 체제의 보안 자동 업데이트를 켜는 것을 강력히 권장합니다. Ubuntu에서는 dpkg-reconfigure -plow unattended-upgrades 명령을 사용합니다. CentOS/RHEL에서는 yum-cron 패키지를 사용합니다.
• SSH 키 대신 비밀번호로 운영 체제에 로그인하는 경우, 강력한 비밀번호를 사용하는지 확인하세요. Ubuntu에서는 apt-get install libpam-cracklib 패키지를 사용합니다. fail2ban 사용을 권장하며, 이는 3회 로그인 실패 시 IP 주소를 10분 동안 차단합니다.
  • Ubuntu: apt-get install fail2ban
  • CentOS/RHEL: sudo yum install fail2ban (EPEL 필요)
• 기본적으로 방화벽을 설치하려면, Ubuntu의 경우 ufw 활성화 또는 CentOS/RHEL 7 및 이후 버전의 경우 firewalld를 사용합니다.

Discourse에 새로운 버전이 업데이트되면, 이메일 주소로 업데이트 알림을 받게 됩니다. 모든 보안 문제가 수정되도록 Discourse 인스턴스를 최신 버전으로 업데이트해 주세요. Discourse의 새로운 버전이 출시되면 이메일 알림을 받게 됩니다. 최신 기능과 보안 수정 사항을 받기 위해 최신 상태를 유지해 주세요. Discourse를 최신 버전으로 업데이트하려면, 브라우저를 통해 /admin/upgrade에 접근한 후 업데이트 버튼을 클릭하세요.

/var/discourse 디렉터리의 launcher 명령은 시스템 수준의 유지 관리를 수행하는 데 사용됩니다:

Usage: launcher COMMAND CONFIG [--skip-prereqs] [--docker-args STRING]
Commands:
    start:      Start/initialize a container (컨테이너 시작/초기화)
    stop:       Stop a running container (실행 중인 컨테이너 중지)
    restart:    Restart a container (컨테이너 재시작)
    destroy:    Stop and remove a container (컨테이너 중지 및 삭제)
    enter:      Use nsenter to get a shell into a container (nsenter를 사용하여 컨테이너 내부 셸에 접근)
    logs:       View the Docker logs for a container (컨테이너의 Docker 로그 보기)
    bootstrap:  Bootstrap a container for the config based on a template (템플릿 기반 구성으로 컨테이너 부트스트랩)
    rebuild:    Rebuild a container (destroy old, bootstrap, start new) (컨테이너 재구축: 기존 컨테이너 삭제, 초기화, 새 컨테이너 시작)
    cleanup:    Remove all containers that have stopped for > 24 hours (24시간 이상 중지된 모든 컨테이너 삭제)

Options:
    --skip-prereqs             Don't check launcher prerequisites (런처 사전 요구 사항 검사 건너뛰기)
    --docker-args              Extra arguments to pass when running docker (docker 실행 시 전달할 추가 인자)

[wjljack (王俊龙)]

번역이 꽤 좋네요. 칭찬 하나요. 공식적으로 다국어 진입점이 있었으면 좋겠습니다.

[honeymoose]

감사합니다.

저희도 Discourse를 사용하면서 중국어 콘텐츠가 너무 적다는 것을 알게 되었습니다. 하지만 Discourse 플랫폼 자체는 정말 훌륭합니다.

설치 과정은 다소 어려움이 있고 몇 가지 사전 요구 사항이 있어, 단순히 머신 하나에 바로 설치할 수 있는 수준은 아닙니다.

하지만 대부분 우회하거나 해결할 수 있어서, 이미 내부에 게시된 내용을 공식 채널에 제출하기로 했습니다.

공식 측에서는 비교적 지원적이고 개방적인 태도를 보이고 있지만, 어떻게 배치하는 것이 적절한지 모르겠어서 다소 어수선해 보입니다.

점진적으로 저희가 이미 가지고 있는 글들도 공식 채널에 제출해 나갈 예정입니다.

[th21]

원래 중국어 포럼이 있었는데, 연초에 폐쇄된 것 같습니다.

[honeymoose]

이전에 이걸 본 기억이 나요. 설치할 때 그들의 몇 가지 글을 참고하기도 했었거든요.

아마 원래版主(운영진)도 유지보수에 시간을 쓸 여유가 없었던 것 같습니다.毕竟 웹사이트를 유지하려면 상당한精力과 경제적 지출이 필요하니까요.

우리는 Discourse에도 익숙하지 않아서 그동안 Discuz를 사용해 왔어요. DISCUZ가 Tencent에 인수된 이후로 몇 년 동안 업데이트가 중단되고 문제가 산더미처럼 쌓여, 업그레이드도 할 수 없는 상태가 되었거든요.

그래서 대안을 찾아보다가 Discourse를 발견했고, 설치해 써보니 꽤 괜찮았어요.

우리가 직접 사용하면서 얻은 경험을 저희의 섹션에 올려두었습니다: iSharkFly - 飞鲨

점차 중국어 자료가 정말 부족하다는 것을 깨닫고, 공식 커뮤니티에 조금이나마 공유해 보자고 생각했어요.

웹사이트를 꾸준히 유지하는 것은 쉽지 않아요.

여러분도 Discourse를 많이 사용해 주셨으면 좋겠습니다. 사용하는 사람이 많을수록 분위기가 살아나고, 실제로 더 흥미로워지니까요.

[th21]

@fantasticfears 이거 아마 중국어 사이트 운영자가 맞는 것 같은데…… 마지막 접속도 19년 전이라서 서버 갱신을 잊었거나 다른 이유가 있는 건지, 중국어 사이트가 갑자기 사라져 버렸어요

[honeymoose]

시간이 없었나 보네요.

괜찮아요, 공식 포럼에서 시간 때우세요. 헷.

[neo (R.Zhang)]

주로 중국인 사용자가 있는 중국어 커뮤니티의 경우, Discourse의 현지화 수준은 여전히 다소 부족한 편입니다. 결국 사용자들의 사용 습관이 다르기 때문이죠.

[honeymoose]

이건 사실입니다. 문자열 매핑 방식으로 번역하는 모든 시스템에 이 문제가 있습니다.

번역된 문자열과 정렬 방식이 좀 이상합니다.

하지만 discourse는 여전히 매우 훌륭하다고 생각합니다. 특히 첨부 파일 업로드가 정말 편리합니다.

콘텐츠는 md 형식입니다. 일반 사용자에게는 학습 곡선이 있지만, 충분히 쓸 만합니다.

가장 중요한 점은 데이터와 저장소가 분리되어 있다는 것입니다. 이 부분은 정말 칭찬할 만합니다. 거의 무제한의 첨부 파일 저장 공간과 내장 CDN을 제공하며, 백업 시 첨부 파일을 따로 신경 쓸 필요가 없습니다. 스크린샷을 많이 올리는 분들에게는 정말 매력적입니다.

[honeymoose]

@honeymoose

번역 원문은 Discourse 클라우드 플랫폼 설치 - Discourse - OSSEZ 에 게시되었습니다. 토론에 참여해 주세요.

OSSEZ 커뮤니티가 도메인을 변경하여, 이 글은 Discourse 云平台安装 - Discourse - iSharkFly 주소에 게시되었습니다.

[Lhc_fl (Linca)]

중국 네트워크 환경 최적화 섹션을 추가해 드렸습니다.