【docker】给你的网站添加聊天对话框 | Chatwoot的部署与使用
本文发布于126天前,最后更新于113天前,其中的信息可能有所发展或是发生改变。如有疑问请联系邮箱:admin@yemengstar.com。

1. 前言

在网页上面添加及时通讯是不是很酷~能和访客面对面交流,毫无障碍!

项目官网:Deploy your self-hosted Chatwoot server | Chatwoot

Chatwoot原生支持不同的部署选项,AWS、AZURE、GCP还有DigitalOcean都提供了便捷部署的方式。免费版本使用限制较多,只提供了网页交流方式。不过一般来说已经足够了。

Docker部署方式:Docker Chatwoot Production deployment guide | Chatwoot

演示:

2. 准备

夜梦这里使用的是雨云的服务器,长期全场景九折 + 首月五折优惠链接:https://www.rainyun.com/

更多服务器推荐请看:服务器推荐 | 部分服务器测评

此项目必须使用域名并开启SSL,通过 namesilo 注册域名可以使用 1 美元优惠码:yemeng。

在开始部署之前,你需要安装 docker 和 docker-compose。此项目需要使用较新的docker与docker-compose版本,安装docker-compose时,请使用夜梦提供的比较新的版本2.23.0。具体安装见:【docker】在服务器上安装 docker/docker-compose

3. 部署

创建文件夹:

mkdir -p /root/data/docker_data/chatwoot
cd /root/data/docker_data/chatwoot

创建环境配置文件:

vim .env

贴入环境配置,具体环境变量的使用可以看官方的文档,夜梦这里就稍微修改一下必要的内容。剩下的都删了~

必须要修改的:

  • SECRET_KEY_BASE:可以在服务器上运行openssl rand -base64 32后,获得生成的随机字符串,然后贴入下面的环境变量中。
  • FRONTEND_URL:使用域名,例如:https://chat.yemengstar.com
  • SMTP相关配置,可以按着自己的服务和需求填写。
  • REDIS_PASSWORD:密码,复杂一点。
  • POSTGRES_PASSWORD:密码,复杂一点。
# 用于验证签名cookie的完整性。因此,请确保设置了一个安全值!
SECRET_KEY_BASE= wa3iuUPFvwvGVeAtbyDlgodSOMnbWEJ98/LWoLLskgI=

# 替换你运行的域名或者IP地址
FRONTEND_URL= https://chat.yemengstar.com

# Force all access to the app over SSL, default is set to false
FORCE_SSL=false

# 注册选项
# true : 允许注册
# false : 关闭注册
# api_only: 关闭UI上的注册,但可以通过API注册
ENABLE_ACCOUNT_SIGNUP=false

# Redis 配置
REDIS_URL=redis://redis:6379
# 设置REDIS的密码,建议复杂一点
REDIS_PASSWORD=xuu3hfXJY+vtfHjV9fGWkzCYi+dL6Qhr66VJUEcEnV0=

# Postgres Database 配置,密码复杂一点
POSTGRES_HOST=postgres
POSTGRES_USERNAME=postgres
POSTGRES_PASSWORD=b00q4eTJHQmVpXsZ2zlsXGKeWr1mcAJ4mgFpca1LnHE=
RAILS_ENV=development
RAILS_MAX_THREADS=5

# 下面时SMTP配置,可以用来配置邮件通知。具体配置信息建议到你的邮箱服务商那里查看。
MAILER_SENDER_EMAIL=Chatwoot <accounts@chatwoot.com>
SMTP_DOMAIN=chatwoot.com
SMTP_ADDRESS=
SMTP_PORT=
SMTP_USERNAME=
SMTP_PASSWORD=
# plain,login,cram_md5
SMTP_AUTHENTICATION=
SMTP_ENABLE_STARTTLS_AUTO=true
# Can be: 'none', 'peer', 'client_once', 'fail_if_no_peer_cert', see http://api.rubyonrails.org/classes/ActionMailer/Base.html
SMTP_OPENSSL_VERIFY_MODE=peer
# 如果您的SMTP服务器需要,请注释掉以下环境变量。
# SMTP_TLS=
# SMTP_SSL=

# Mail Incoming
# 下面是连续会话使用的邮箱
MAILER_INBOUND_EMAIL_DOMAIN=
# 将此设置为适当的接收渠道,以接收到电子邮件
# 支持的邮箱 :
# relay for Exim, Postfix, Qmail
# mailgun for Mailgun
# mandrill for Mandrill
# postmark for Postmark
# sendgrid for Sendgrid
RAILS_INBOUND_EMAIL_SERVICE=
# 根据电子邮件入口服务,使用以下其中一个
# 参考: https://edgeguides.rubyonrails.org/action_mailbox_basics.html
# 将其设置为您选择的密码,并在入站webhook中使用它
RAILS_INBOUND_EMAIL_PASSWORD=

MAILGUN_INGRESS_SIGNING_KEY=
MANDRILL_INGRESS_API_KEY=

# Creating Your Inbound Webhook Instructions for Postmark and Sendgrid:
# Inbound webhook URL format:
#    https://actionmailbox:[YOUR_RAILS_INBOUND_EMAIL_PASSWORD]@[YOUR_CHATWOOT_DOMAIN.COM]/rails/action_mailbox/[RAILS_INBOUND_EMAIL_SERVICE]/inbound_emails
# Note: Replace the values inside the brackets; do not include the brackets themselves.
# Example: https://actionmailbox:mYRandomPassword3@chatwoot.example.com/rails/action_mailbox/postmark/inbound_emails
# For Postmark
# Ensure the 'Include raw email content in JSON payload' checkbox is selected in the inbound webhook section.

# 存储信息的形式,默认本地
ACTIVE_STORAGE_SERVICE=local

# Amazon S3
# 参考文档: https://www.chatwoot.com/docs/configuring-s3-bucket-as-cloud-storage
S3_BUCKET_NAME=
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=

# 日志设置
RAILS_LOG_TO_STDOUT=true
LOG_LEVEL=info
LOG_SIZE=500

# 省事儿起见,后面夜梦全给他删了。需要的小伙伴可以看官方的文档加上。

创建compose文件:

vim docker-compose.yaml

贴入配置,其中要把POSTGRES_PASSWORD修改为上面环境变量中设置过的那个密码。

version: '3'

services:
  base: &base
    image: chatwoot/chatwoot:latest
    env_file: .env ## 环境变量文件的名字
    volumes:
      - ./data/storage:/app/storage

  rails:
    <<: *base
    depends_on:
      - postgres
      - redis
    ports:
      - 5678:3000
    environment:
      - NODE_ENV=production
      - RAILS_ENV=production
      - INSTALLATION_ENV=docker
    entrypoint: docker/entrypoints/rails.sh
    command: ['bundle', 'exec', 'rails', 's', '-p', '3000', '-b', '0.0.0.0']

  sidekiq:
    <<: *base
    depends_on:
      - postgres
      - redis
    environment:
      - NODE_ENV=production
      - RAILS_ENV=production
      - INSTALLATION_ENV=docker
    command: ['bundle', 'exec', 'sidekiq', '-C', 'config/sidekiq.yml']

  postgres:
    image: postgres:12
    restart: always
    # ports:
    #  - 5432:5432
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=chatwoot
      - POSTGRES_USER=postgres
      # 环境变量里面设置的密码
      - POSTGRES_PASSWORD=b00q4eTJHQmVpXsZ2zlsXGKeWr1mcAJ4mgFpca1LnHE=

  redis:
    image: redis:alpine
    restart: always
    command: ["sh", "-c", "redis-server --requirepass \"$REDIS_PASSWORD\""]
    env_file: .env
    volumes:
      - ./data/redis:/data
    # ports:
    #  - 6379:6379

准备数据库,要点时间,稍作等待~

docker compose run --rm rails bundle exec rails db:chatwoot_prepare

当出现Created database 'chatwoot_production'说明完成了。

启动:

docker-compose down
docker-compose up -d

备注:chatwoot-base-1不会运行,显示的是exit状态,不影响使用。

base container is an intermediatory container used to build the rails and sidekiq ones. It is not expected to be running.

4. 反向代理

你需要完成反向代理并开启 SSL,具体为你的域名 -> 服务器IP:5678,反代可以参考下面两篇文章:

【docker】反向代理神器 ——Nginx Proxy Manager 的安装

【docker】Nginx Proxy Manager 的使用

5. 使用

访问你的域名,就可以进入初始化界面。

注册完登录即可。

修改界面语言为中文:

创建会话:

选择website:

完成基础内容的设置:

直接过:

获取js代码:

可以直接在网站里面看到了~

我们在网页发送消息:

就可以在后台看到消息了,直接就可以回复~

网站这边也能立即看到~

本文为夜梦星尘原创文章。
文章作者:夜梦星尘
文章链接:【docker】给你的网站添加聊天对话框 | Chatwoot的部署与使用
版权声明:本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自夜梦星尘
支持作者:夜梦星尘的爱发电
上一篇
下一篇