Sou um novato em desenvolvimento web e, por hobby, quero montar uma comunidade de intercâmbio técnico. Estou planejando configurar um Discourse e compartilhar este tutorial, na esperança de que ajude aqueles que precisam instalar o Discourse, evitando armadilhas. Há poucos tutoriais em chinês sobre Discourse, e alguns já estão desatualizados. Passei vários dias pesquisando, dependendo apenas de software de tradução.
O que você precisa para criar seu próprio Discourse:
Um servidor leve Aliyun em Hong Kong. Baixar plugins do GitHub em servidores domésticos é como uma lesma, então recomendo usar o servidor leve Aliyun em Hong Kong ou outro servidor leve. Servidores leves são mais baratos e adequados para iniciantes. A configuração requer mais de 2 GB de RAM, caso contrário, a instalação falhará. Se você precisar instalar em um servidor doméstico, pode usar um servidor em Hong Kong com pagamento por uso e, em seguida, usar a função de criação de imagem na plataforma para clonar para o servidor doméstico, o que economizará tempo de pesquisa de armadilhas.
Um domínio curto e fácil de lembrar, com resolução para o IP do servidor. Recomendo .com e .net. Outros domínios carecem de reconhecimento. Você pode pesquisar domínios em Pesquisa em Massa de Domínios, usando a pesquisa por regras para encontrar domínios curtos.
Sistema: Ubuntu 20.04, que é mais comum.
Após ativar um novo servidor, abra todas as portas do firewall primeiro (após a depuração, feche as portas conforme necessário, mantendo apenas as portas usadas, para evitar ataques de hackers). Defina a senha do root no painel de controle e, em seguida, conecte-se remotamente ao servidor via SSH diretamente pela web ou baixe um software SSH como XTerminal.
Em seguida, cole os três comandos abaixo e pressione Enter para executá-los. Quando houver opções, pressione “yes” para atualizar a fonte do sistema e instalar o software git.
apt update
apt upgrade -y
apt install git
Em seguida, cole os três comandos abaixo e pressione Enter para executá-los como administrador. Esta etapa sudo -s se não for feita com cuidado, pode haver mensagens de erro de criação inexplicáveis durante a instalação, levando à falha na instalação, pois falta permissão.
sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
chmod 700 containers
Após o download, execute o assistente de instalação
./discourse-setup
Em seguida, insira o domínio a ser vinculado de acordo com as instruções. A primeira instalação leva muito tempo. Recomenda-se preencher aleatoriamente outros domínios além do domínio principal, e depois reconstruir após o sucesso. Se você não entender, pode usar capturas de tela e tradução de imagens do WeChat. Para e-mails, você pode usar o Serviço de E-mail Aliyun.
Em seguida, haverá uma mensagem perguntando se você deseja continuar a instalação ou cancelar pressionando Ctrl+C. Recomenda-se continuar a instalação.
Após a conclusão da instalação, acesse o domínio vinculado. Se a página de registro aparecer, significa que o Discourse foi instalado com sucesso.
Em seguida, instale um painel Linux. Esta etapa é principalmente para instalar outros programas de site e facilitar o gerenciamento “plug and play” para iniciantes. Comparei e este painel é muito mais simples que o Baota, com menos anúncios e instalação rápida em poucos segundos, ao contrário do Baota que requer compilação de ambiente por muito tempo.
Execute o script abaixo:
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh & sudo bash quick_start.sh
Durante a instalação, ele detectará que o Docker já foi instalado e, em seguida, exibirá o login no backend.
Siga as instruções, encontre o backend e faça o login. Em Gerenciamento de Contêineres, você pode ver o aplicativo, que é o Discourse, e pode iniciá-lo ou pará-lo aqui.
Em seguida, entre no arquivo e edite o app.yml. As principais modificações são comentadas em chinês.
## this is the all-in-one, standalone Discourse Docker container template
##
## After making changes to this file, you MUST rebuild
## /var/discourse/launcher rebuild app
##
## BE *VERY* CAREFUL WHEN EDITING!
## YAML FILES ARE SUPER SUPER SENSITIVE TO MISTAKES IN WHITESPACE OR ALIGNMENT!
## visit http://www.yamllint.com/ to validate this file as needed
templates:
- "templates/postgres.template.yml"
- "templates/redis.template.yml"
- "templates/web.template.yml"
## Uncomment the next line to enable the IPv6 listener
#- "templates/web.ipv6.template.yml"
- "templates/web.ratelimited.template.yml"
## Uncomment these two lines if you wish to add Lets Encrypt (https)
- "templates/web.ssl.template.yml"
- "templates/web.letsencrypt.ssl.template.yml"
## which TCP/IP ports should this container expose?
## If you want Discourse to share a port with another webserver like Apache or nginx,
## see https://meta.discourse.org/t/17247 for details
expose:
- "80:80" # http
- "443:443" # https
params:
db_default_text_search_config: "pg_catalog.english"
## Set db_shared_buffers to a max of 25% of the total memory.
## will be set automatically by bootstrap based on detected RAM, or you can override
db_shared_buffers: "128MB"
## Modificar o tamanho máximo de upload de anexos
upload_size: 300m
## can improve sorting performance, but adds memory usage per-connection
#db_work_mem: "40MB"
## Which Git revision should this container use? (default: tests-passed)
#version: tests-passed
env:
LC_ALL: en_US.UTF-8
LANG: en_US.UTF-8
LANGUAGE: en_US.UTF-8
DISCOURSE_DEFAULT_LOCALE: zh_CN
## How many concurrent web requests are supported? Depends on memory and CPU cores.
## will be set automatically by bootstrap based on detected CPUs, or you can override
UNICORN_WORKERS: 2
## TODO: The domain name this Discourse instance will respond to
## Required. Discourse will not work with a bare IP number.
## Modificar o domínio principal
DISCOURSE_HOSTNAME: bbs.izdh.net
## Uncomment if you want the container to be started with the same
## hostname (-h option) as specified above (default "$hostname-$config")
#DOCKER_USE_HOSTNAME: true
## TODO: List of comma delimited emails that will be made admin and developer
## on initial signup example 'user1@example.com,user2@example.com'
## Modificar e-mail do administrador
DISCOURSE_DEVELOPER_EMAILS: 'xxxx@gmail.com'
## TODO: The SMTP mail server used to validate new accounts and send notifications
# SMTP ADDRESS, username, and password are required
# WARNING the char '#' in SMTP password can cause problems!
## Modificar servidor de e-mail de envio
DISCOURSE_SMTP_ADDRESS: smtpdm.aliyun.com
## Modificar porta do e-mail de envio
DISCOURSE_SMTP_PORT: 80
## Modificar para conta de e-mail de envio automático
DISCOURSE_SMTP_USER_NAME: xxxx@xxx.net
## Modificar senha do e-mail de envio
DISCOURSE_SMTP_PASSWORD: "dj6bCRxoHt25NcD6"
#DISCOURSE_SMTP_ENABLE_START_TLS: true # (optional, default true)
DISCOURSE_SMTP_DOMAIN: smtpdm.aliyun.com
## Modificar para conta de e-mail de envio automático
DISCOURSE_NOTIFICATION_EMAIL: xxxx@xxx.net
DISCOURSE_SMTP_ENABLE_START_TLS: false
## If you added the Lets Encrypt template, uncomment below to get a free SSL certificate
LETSENCRYPT_ACCOUNT_EMAIL: me@example.com
## The http or https CDN address for this Discourse instance (configured to pull)
## see https://meta.discourse.org/t/14857 for details
#DISCOURSE_CDN_URL: https://discourse-cdn.example.com
## The maxmind geolocation IP address key for IP address lookup
## see https://meta.discourse.org/t/-/137387/23 for details
#DISCOURSE_MAXMIND_LICENSE_KEY: 1234567890123456
## The Docker container is stateless; all data is stored in /shared
volumes:
- volume:
host: /var/discourse/shared/standalone
guest: /shared
- volume:
host: /var/discourse/shared/standalone/log/var-log
guest: /var/log
## Plugins go here
## see https://meta.discourse.org/t/19157 for details
## Instalar 2 plugins
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/docker_manager.git
- git clone https://github.com/discourse/discourse-solved
- git clone https://github.com/discourse/discourse-reactions
## Any custom commands to run after building
run:
- exec: echo "Beginning of custom commands"
## If you want to set the 'From' email address for your first registration, uncomment and change:
## After getting the first signup email, re-comment the line. It only needs to run once.
#- exec: rails r "SiteSetting.notification_email='info@unconfigured.discourse.org'"
- exec: echo "End of custom commands"
Após modificar e salvar, volte ao terminal, use o comando ou pare o contêiner no backend e, em seguida, reconstrua. No entanto, parece que se você não instalou este painel, não precisa parar o contêiner. Reconstruir diretamente após instalar este painel resultará em erro.
./launcher stop app
./launcher bootstrap app
Aguarde a conclusão da reconstrução e execute o comando de inicialização do contêiner.
./launcher start app
Ao entrar no Discourse, ele solicitará o envio de um e-mail para ativação. Se você não receber, pode usar o comando abaixo para criar uma conta de administrador e pular diretamente. Em seguida, defina o idioma para chinês nas configurações à esquerda. Há também um local para testar o envio de e-mails, que indicará o motivo do erro. Tente algumas vezes e você terá sucesso.
./launcher enter app
rake admin:create
Se você precisar criar outros sites, consulte diretamente o tutorial oficial. É simples, então não vou detalhar. Você também pode criar um novo ambiente no site, modificar as permissões do site para 777 e, em seguida, instalar vários programas.
O principal problema resolvido é que vários sites podem ser executados em um único servidor, economizando custos de compra de servidores e sendo mais adequado para iniciantes.
Posteriormente, ao testar o envio de e-mails, descobri um problema:
Essas configurações do contêiner, editadas no app.yml, não parecem ter efeito na reconstrução. É necessário modificar nas variáveis de ambiente do contêiner, mas leva apenas 5-6 segundos para entrar em vigor. Ainda não está claro se isso afeta a instalação de plugins.
A coexistência com outros sites parece envolver a criação de um proxy reverso primeiro, depois a alteração da porta padrão 443 do contêiner para 10443, e a configuração do certificado para acesso normal.
Proxy Reverso
Configuração do Certificado
Mas editar o arquivo de configuração não adiantou, pois o rebuild não teve efeito. No entanto, alterar as variáveis de ambiente do contêiner funcionou maravilhosamente em meros segundos, poupando-me do incômodo de reconstruir. O impacto nos plugins permanece incerto por enquanto.
