19:I[15621,["/_next/static/immutable/chunks/3gm-8e62xn1qd.js","/_next/static/immutable/chunks/0n2yq6f-f75k2.js"],"ArticleReader"] 1a:T990,

services:
  postgresql:
    image: bitnami/postgresql:latest
    volumes:
      - "postgresql_data:/bitnami/postgresql"
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
      - POSTGRESQL_USERNAME=bn_discourse
      - POSTGRESQL_DATABASE=bitnami_discourse
  redis:
    image: bitnami/redis:latest
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
    volumes:
      - "redis_data:/bitnami/redis"
  discourse:
    image: bitnami/discourse:3
    ports:
      - "80:3000"
    volumes:
      - "discourse_data:/bitnami/discourse"
    depends_on:
      - postgresql
      - redis
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
      - DISCOURSE_HOST=127.0.0.1
      - DISCOURSE_DATABASE_HOST=postgresql
      - DISCOURSE_DATABASE_PORT_NUMBER=5432
      - DISCOURSE_DATABASE_USER=bn_discourse
      - DISCOURSE_DATABASE_NAME=bitnami_discourse
      - DISCOURSE_REDIS_HOST=redis
      - DISCOURSE_REDIS_PORT_NUMBER=6379
  sidekiq:
    image: bitnami/discourse:3
    depends_on:
      - discourse
    volumes:
      - "sidekiq_data:/bitnami/discourse"
    command: /opt/bitnami/scripts/discourse-sidekiq/run.sh
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
      - DISCOURSE_HOST=127.0.0.1
      - DISCOURSE_DATABASE_HOST=postgresql
      - DISCOURSE_DATABASE_PORT_NUMBER=5432
      - DISCOURSE_DATABASE_USER=bn_discourse
      - DISCOURSE_DATABASE_NAME=bitnami_discourse
      - DISCOURSE_REDIS_HOST=redis
      - DISCOURSE_REDIS_PORT_NUMBER=6379
volumes:
  postgresql_data:
    driver: local
  redis_data:
    driver: local
  discourse_data:
    driver: local
  sidekiq_data:
    driver: local

1b:T695,1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162services: postgresql: image: bitnami/postgresql:latest volumes: - "postgresql_data:/bitnami/postgresql" environment: # ALLOW_EMPTY_PASSWORD is recommended only for development. - ALLOW_EMPTY_PASSWORD=yes - POSTGRESQL_USERNAME=bn_discourse - POSTGRESQL_DATABASE=bitnami_discourse redis: image: bitnami/redis:latest environment: # ALLOW_EMPTY_PASSWORD is recommended only for development. - ALLOW_EMPTY_PASSWORD=yes volumes: - "redis_data:/bitnami/redis" discourse: image: bitnami/discourse:3 ports: - "80:3000" volumes: - "discourse_data:/bitnami/discourse" depends_on: - postgresql - redis environment: # ALLOW_EMPTY_PASSWORD is recommended only for development. - ALLOW_EMPTY_PASSWORD=yes - DISCOURSE_HOST=127.0.0.1 - DISCOURSE_DATABASE_HOST=postgresql - DISCOURSE_DATABASE_PORT_NUMBER=5432 - DISCOURSE_DATABASE_USER=bn_discourse - DISCOURSE_DATABASE_NAME=bitnami_discourse - DISCOURSE_REDIS_HOST=redis - DISCOURSE_REDIS_PORT_NUMBER=6379 sidekiq: image: bitnami/discourse:3 depends_on: - discourse volumes: - "sidekiq_data:/bitnami/discourse" command: /opt/bitnami/scripts/discourse-sidekiq/run.sh environment: # ALLOW_EMPTY_PASSWORD is recommended only for development. - ALLOW_EMPTY_PASSWORD=yes - DISCOURSE_HOST=127.0.0.1 - DISCOURSE_DATABASE_HOST=postgresql - DISCOURSE_DATABASE_PORT_NUMBER=5432 - DISCOURSE_DATABASE_USER=bn_discourse - DISCOURSE_DATABASE_NAME=bitnami_discourse - DISCOURSE_REDIS_HOST=redis - DISCOURSE_REDIS_PORT_NUMBER=6379volumes: postgresql_data: driver: local redis_data: driver: local discourse_data: driver: local sidekiq_data: driver: local1c:T6ba,

# A container for all things Data, be sure to set a secret password for
# discourse account, SOME_SECRET is just an example
#

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"

# any extra arguments for Docker?
# docker_args:

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: "256MB"

  ## can improve sorting performance, but adds memory usage per-connection
  #db_work_mem: "40MB"

expose:
  - "5432:5432"   # http
  - "6379:6379" # https

env:
  # ensure locale exists in container, you may need to install it
  LC_ALL: en_US.UTF-8
  LANG: en_US.UTF-8
  LANGUAGE: en_US.UTF-8

  #......省略

volumes:
  - volume:
        host: /var/discourse/shared/data
        guest: /shared
  - volume:
        host: /var/discourse/shared/data/log/var-log
        guest: /var/log

# TODO: SOME_SECRET to a password for the discourse user
hooks:
  after_postgres:
    - exec:
        stdin: |
          alter user discourse with password 'SOME_SECRET';
        cmd: su - postgres -c 'psql discourse'

        raise_on_fail: false

1d:T4b2,1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950# A container for all things Data, be sure to set a secret password for# discourse account, SOME_SECRET is just an example#templates: - "templates/postgres.template.yml" - "templates/redis.template.yml"# any extra arguments for Docker?# docker_args: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: "256MB" ## can improve sorting performance, but adds memory usage per-connection #db_work_mem: "40MB"expose: - "5432:5432" # http - "6379:6379" # httpsenv: # ensure locale exists in container, you may need to install it LC_ALL: en_US.UTF-8 LANG: en_US.UTF-8 LANGUAGE: en_US.UTF-8 #......省略volumes: - volume: host: /var/discourse/shared/data guest: /shared - volume: host: /var/discourse/shared/data/log/var-log guest: /var/log# TODO: SOME_SECRET to a password for the discourse userhooks: after_postgres: - exec: stdin: | alter user discourse with password 'SOME_SECRET'; cmd: su - postgres -c 'psql discourse' raise_on_fail: false1e:T4ed,

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:       Open a shell to run commands inside the container
    logs:        View the Docker logs for a container
    bootstrap:   Bootstrap a container for the config based on a template
    run:         Run the given command with the config in the context of the last bootstrapped image
    rebuild:     Rebuild a container (destroy old, bootstrap, start new)
    cleanup:     Remove all containers that have stopped for > 24 hours
    start-cmd:   Generate docker command used to start container

Options:
    --skip-prereqs             Don't check launcher prerequisites
    --docker-args              Extra arguments to pass when running docker
    --skip-mac-address         Don't assign a mac address
    --run-image                Override the image used for running the container

1f:T464,

env:
  ...
  DISCOURSE_RELATIVE_URL_ROOT: /forum

run:
    - exec:
        cd: $home
        cmd:
          - mkdir -p public/forum
          - cd public/forum && ln -s ../uploads && ln -s ../backups
    - replace:
       global: true
       filename: /etc/nginx/conf.d/discourse.conf
       from: proxy_pass http://discourse;
       to: |
          rewrite ^/(.*)$ /forum/$1 break;
          proxy_pass http://discourse;
    - replace:
       filename: /etc/nginx/conf.d/discourse.conf
       from: etag off;
       to: |
          etag off;
          location /forum {
             rewrite ^/forum/?(.*)$ /$1;
          }
    - replace:
         filename: /etc/nginx/conf.d/discourse.conf
         from: $proxy_add_x_forwarded_for
         to: $http_your_original_ip_header
         global: true

20:T5ee,

export default class ProfileCustomLink extends Component {
  @service site;
  @service api;

  @tracked customLinkUrl;
  @tracked customLinkFieldId;
  @tracked showCustomLink = false;
  @tracked user = this.args.model.username;
  @tracked userId = this.args.model.id;
  @tracked userFields = this.args.model.user_fields;

  constructor() {
    super(...arguments);
    console.info("[Custom Profile Link] model", this.args.model);
    this.fetchExternalIds().then((oauth2BasicId) => {
      const url = settings.profile_custom_link_prefix + (oauth2BasicId == null ? '' : oauth2BasicId);
      this.customLinkUrl = url;
      this.showCustomLink = true;
    });
  }

  async fetchExternalIds() {
    try {
      const response = await ajax(`/admin/users/${this.userId}.json`, {
        headers: {
          "Api-Key": settings.profile_custom_link_api_key,
          "Api-Username": settings.profile_custom_link_api_username
        }
      });
      const oauth2BasicId = response.external_ids?.oauth2_basic;
      return oauth2BasicId
    } catch (error) {
      console.error("[Custom Profile Link] Error fetching external IDs:", error);
    }
  }
}

21:T433,12345678910111213141516171819202122232425262728293031323334353637export default class ProfileCustomLink extends Component { @service site; @service api; @tracked customLinkUrl; @tracked customLinkFieldId; @tracked showCustomLink = false; @tracked user = this.args.model.username; @tracked userId = this.args.model.id; @tracked userFields = this.args.model.user_fields; constructor() { super(...arguments); console.info("[Custom Profile Link] model", this.args.model); this.fetchExternalIds().then((oauth2BasicId) => { const url = settings.profile_custom_link_prefix + (oauth2BasicId == null ? '' : oauth2BasicId); this.customLinkUrl = url; this.showCustomLink = true; }); } async fetchExternalIds() { try { const response = await ajax(`/admin/users/${this.userId}.json`, { headers: { "Api-Key": settings.profile_custom_link_api_key, "Api-Username": settings.profile_custom_link_api_username } }); const oauth2BasicId = response.external_ids?.oauth2_basic; return oauth2BasicId } catch (error) { console.error("[Custom Profile Link] Error fetching external IDs:", error); } }}22:T77b,

.
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.md
├── app
│   └── controllers # 增加后端API 入口
│       └── discourse_profile
│           └── profile_controller.rb
├── assets
│   ├── javascripts
│   │   └── discourse
│   │       ├── components # 前端组件
│   │       │   └── profile-link.js
│   │       ├── connectors # 页面注入槽点
│   │       │   ├── user-card-post-names # 槽点
│   │       │   │   └── profile-link.hbs
│   │       │   └── user-location-and-website # 槽点
│   │       │       └── profile-link.hbs
│   │       └── templates
│   │           └── components
│   │               └── profile-link.hbs # 页面模板文件
│   └── stylesheets
│       └── common
│           └── profile.scss
├── config
│   ├── locales
│   │   └── client.en.yml # 国际化
│   ├── routes.rb # 路由配置
│   └── settings.yml # 配置参数
├── db
├── eslint.config.mjs
├── lib
│   └── profile_link
│       └── engine.rb
├── package.json
├── plugin.rb    # 插件注册和配置的入口
├── pnpm-lock.yaml
├── spec
│   └── system
│       └── core_features_spec.rb
├── stylelint.config.mjs
└── test
    └── javascripts

23:T5b6,

import Component from "@glimmer/component";
import { inject as service } from "@ember/service";
import { hbs } from "ember-cli-htmlbars";


export default class CategoryResources extends Component {
    @service router;
    @service siteSettings;

    constructor() {
        super(...arguments);
    }

    get categoryResources() {

        try {
            ....
        } catch (error) {
            console.error("...", error);
            return [];
        }
    }



    <template>
          <div class="resources-grid">
                        {{#each this.categoryResources as |resource|}}
                            <a href={{resource.url}}
                               target="_blank"
                               rel="noopener noreferrer"
                               class="resource-item"
                               title={{resource.description}}>
                                {{resource.name}}
                            </a>
                        {{/each}}
                    </div>
    </template>
}

11:["$","main",null,{"className":"reader-page","children":[["$","div",null,{"className":"reader-kicker","children":[["$","$L10",null,{"href":"/sources/55882a5c594529c5","children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":16,"height":16,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-arrow-left","children":[["$","path","1l729n",{"d":"m12 19-7-7 7-7"}],["$","path","x3x0zl",{"d":"M19 12H5"}],"$undefined"]}]," 返回 ","TrumanDu's Blog"]}],["$","span",null,{"children":"工程"}]]}],["$","header",null,{"className":"article-meta","children":[["$","span",null,{"children":["FROM · ","TrumanDu's Blog"]}],["$","div",null,{"children":[["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":15,"height":15,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-calendar-days","children":[["$","path","1cmpym",{"d":"M8 2v4"}],["$","path","4m81vk",{"d":"M16 2v4"}],["$","rect","1hopcy",{"width":"18","height":"18","x":"3","y":"4","rx":"2"}],["$","path","8toen8",{"d":"M3 10h18"}],["$","path","6423bh",{"d":"M8 14h.01"}],["$","path","1etili",{"d":"M12 14h.01"}],["$","path","1gbofw",{"d":"M16 14h.01"}],["$","path","lrp35t",{"d":"M8 18h.01"}],["$","path","mhygvu",{"d":"M12 18h.01"}],["$","path","kzsmim",{"d":"M16 18h.01"}],"$undefined"]}]," ","2025年6月7日"," · TrumanDu"]}]]}],["$","$L19",null,{"article":{"title":"Discourse 调研笔记","byline":"TrumanDu","publishedAt":"2025-06-07T13:12:47.682Z","language":"en","blocks":[{"id":"b0","type":"quote","html":"

\n
插播一条广告，专业承接 discourse 开发，包含不限于主题，插件等功能自定义开发，需要的可以关注我的公众号，私信我。
\n

","text":"插播一条广告，专业承接 discourse 开发，包含不限于主题，插件等功能自定义开发，需要的可以关注我的公众号，私信我。"},{"id":"b1","type":"paragraph","html":"

最近一个月的工作都集中在公司要搭建一个 Gamer Community 上，经过多个角度，多种开源，商业方案对比，最终选择了 discourse。

","text":"最近一个月的工作都集中在公司要搭建一个 Gamer Community 上，经过多个角度，多种开源，商业方案对比，最终选择了 discourse。"},{"id":"b2","type":"paragraph","html":"

多说一句对于一个论坛技术选型，以前没有这方面的储备，最终的选择也是 AI 推荐的。领导下发任务用 AI 拆分，作为员工的我们，利用 AI 完成我们的方案调研和工作汇报，完美闭环！这么想，工资就白嫖来的！

","text":"多说一句对于一个论坛技术选型，以前没有这方面的储备，最终的选择也是 AI 推荐的。领导下发任务用 AI 拆分，作为员工的我们，利用 AI 完成我们的方案调研和工作汇报，完美闭环！这么想，工资就白嫖来的！"},{"id":"b3","type":"heading","html":"

部署

","text":"部署"},{"id":"b4","type":"paragraph","html":"

由于官方社区没有 docker 镜像，快速部署会有一点点麻烦，目前我推荐的 Discourse 有两种方式：

","text":"由于官方社区没有 docker 镜像，快速部署会有一点点麻烦，目前我推荐的 Discourse 有两种方式："},{"id":"b5","type":"list","html":"

官方社区方案
VMware 旗下bitnami/discourse

","text":"官方社区方案 VMware 旗下bitnami/discourse"},{"id":"b6","type":"heading","html":"

bitnami/discourse 部署

","text":"bitnami/discourse 部署"},{"id":"b7","type":"paragraph","html":"

最快速的方案推荐 bitnami，一个 docker-compose.yml 一条命令就可以跑起来。

","text":"最快速的方案推荐 bitnami，一个 docker-compose.yml 一条命令就可以跑起来。"},{"id":"b8","type":"paragraph","html":"$1a","text":"$1b"},{"id":"b9","type":"paragraph","html":"

启动命令：docker compose up -d
删除容器和数据：docker compose down --volumes

","text":"启动命令：docker compose up -d删除容器和数据：docker compose down --volumes"},{"id":"b10","type":"heading","html":"

官方部署方案

","text":"官方部署方案"},{"id":"b11","type":"paragraph","html":"

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

","text":"1234sudo -sgit clone https://github.com/discourse/discourse_docker.git /var/discoursecd /var/discoursechmod 700 containers"},{"id":"b12","type":"paragraph","html":"

安装向导，初始化配置文件

","text":"安装向导，初始化配置文件"},{"id":"b13","type":"paragraph","html":"

./discourse-setup

","text":"1./discourse-setup"},{"id":"b14","type":"paragraph","html":"

基于模板为配置启动一个容器

","text":"基于模板为配置启动一个容器"},{"id":"b15","type":"paragraph","html":"

./launcher bootstrap app

","text":"1./launcher bootstrap app"},{"id":"b16","type":"heading","html":"

搭建单独 DB 服务

","text":"搭建单独 DB 服务"},{"id":"b17","type":"paragraph","html":"

如果需要 db 和应用分离的话，那么新增一个 data.yml 模板。数据库定义端口和密码可以通过修改 redis.template.yml 和 postgres.template.yml 实现。

","text":"如果需要 db 和应用分离的话，那么新增一个 data.yml 模板。数据库定义端口和密码可以通过修改 redis.template.yml 和 postgres.template.yml 实现。"},{"id":"b18","type":"paragraph","html":"

直接修改 templates/redis.template.yml

","text":"直接修改 templates/redis.template.yml"},{"id":"b19","type":"paragraph","html":"

params:
  redis_io_threads: \"1\"
  redis_port: \"6379\"
  redis_password: \"*******\"

run:
    #.....
    # Add port configuration
  - replace:
      filename: \"/etc/redis/redis.conf\"
      from: /^port.*$/
      to: \"port $redis_port\"

  # Add password configuration
  - replace:
      filename: \"/etc/redis/redis.conf\"
      from: /^# requirepass.*$/
      to: \"requirepass $redis_password\"

","text":"123456789101112131415161718params: redis_io_threads: \"1\" redis_port: \"6379\" redis_password: \"*******\"run: #..... # Add port configuration - replace: filename: \"/etc/redis/redis.conf\" from: /^port.*$/ to: \"port $redis_port\" # Add password configuration - replace: filename: \"/etc/redis/redis.conf\" from: /^# requirepass.*$/ to: \"requirepass $redis_password\""},{"id":"b20","type":"paragraph","html":"

直接修改 templates/postgres.template.yml

","text":"直接修改 templates/postgres.template.yml"},{"id":"b21","type":"paragraph","html":"

params:
  db_port: \"5432\"

run:
  #......
  # 配置端口
  - replace:
      filename: \"/etc/postgresql/15/main/postgresql.conf\"
      from: /#?port *=.*/
      to: \"port = $db_port\"

","text":"12345678910params: db_port: \"5432\"run: #...... # 配置端口 - replace: filename: \"/etc/postgresql/15/main/postgresql.conf\" from: /#?port *=.*/ to: \"port = $db_port\""},{"id":"b22","type":"paragraph","html":"

进去容器内部修改账户密码

","text":"进去容器内部修改账户密码"},{"id":"b23","type":"paragraph","html":"

su postgres -c \"psql $db_name -c \\\"ALTER USER postgres WITH PASSWORD 'your_new_password'\\\";

","text":"1su postgres -c \"psql $db_name -c \\\"ALTER USER postgres WITH PASSWORD 'your_new_password'\\\";"},{"id":"b24","type":"paragraph","html":"

data.yml 配置文件

","text":"data.yml 配置文件"},{"id":"b25","type":"paragraph","html":"$1c","text":"$1d"},{"id":"b26","type":"paragraph","html":"

基于 data.yml 模板搭建 db 容器

","text":"基于 data.yml 模板搭建 db 容器"},{"id":"b27","type":"paragraph","html":"

./launcher rebuild db

","text":"1./launcher rebuild db"},{"id":"b28","type":"paragraph","html":"$1e","text":"1234567891011121314151617181920Usage: 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: Open a shell to run commands inside the container logs: View the Docker logs for a container bootstrap: Bootstrap a container for the config based on a template run: Run the given command with the config in the context of the last bootstrapped image rebuild: Rebuild a container (destroy old, bootstrap, start new) cleanup: Remove all containers that have stopped for > 24 hours start-cmd: Generate docker command used to start containerOptions: --skip-prereqs Don't check launcher prerequisites --docker-args Extra arguments to pass when running docker --skip-mac-address Don't assign a mac address --run-image Override the image used for running the container"},{"id":"b29","type":"paragraph","html":"

重新构建一个容器

","text":"重新构建一个容器"},{"id":"b30","type":"paragraph","html":"

1
2

./launcher rebuild app

","text":"12./launcher rebuild app"},{"id":"b31","type":"paragraph","html":"

启动/停止应用

","text":"启动/停止应用"},{"id":"b32","type":"paragraph","html":"

1
2

./launcher start app
./launcher stop app

","text":"12./launcher start app./launcher stop app"},{"id":"b33","type":"paragraph","html":"

进入容器

","text":"进入容器"},{"id":"b34","type":"paragraph","html":"

./launcher enter app

","text":"1./launcher enter app"},{"id":"b35","type":"paragraph","html":"

创建管理员账户

","text":"创建管理员账户"},{"id":"b36","type":"paragraph","html":"

rake admin:create

","text":"1rake admin:create"},{"id":"b37","type":"heading","html":"

子路径部署

","text":"子路径部署"},{"id":"b38","type":"paragraph","html":"

官方文档

","text":"官方文档"},{"id":"b39","type":"paragraph","html":"

例如我们要使用https://www.example.com/forum 访问论坛，这种就属于子路径部署。

","text":"例如我们要使用https://www.example.com/forum 访问论坛，这种就属于子路径部署。"},{"id":"b40","type":"paragraph","html":"

在 app.yml 文件中添加相应信息，重新编译就可以了。

","text":"在 app.yml 文件中添加相应信息，重新编译就可以了。"},{"id":"b41","type":"paragraph","html":"$1f","text":"12345678910111213141516171819202122232425262728293031env: ... DISCOURSE_RELATIVE_URL_ROOT: /forumrun: - exec: cd: $home cmd: - mkdir -p public/forum - cd public/forum && ln -s ../uploads && ln -s ../backups - replace: global: true filename: /etc/nginx/conf.d/discourse.conf from: proxy_pass http://discourse; to: | rewrite ^/(.*)$ /forum/$1 break; proxy_pass http://discourse; - replace: filename: /etc/nginx/conf.d/discourse.conf from: etag off; to: | etag off; location /forum { rewrite ^/forum/?(.*)$ /$1; } - replace: filename: /etc/nginx/conf.d/discourse.conf from: $proxy_add_x_forwarded_for to: $http_your_original_ip_header global: true"},{"id":"b42","type":"paragraph","html":"

部署好以后，就可以访问了，如果存在本地上传的静态文件，就需要修改一下文件路径。

","text":"部署好以后，就可以访问了，如果存在本地上传的静态文件，就需要修改一下文件路径。"},{"id":"b43","type":"paragraph","html":"

1
2

./launcher enter app
RAILS_ENV=production bundle exec script/discourse remap '/uploads' '/forum/uploads'

","text":"12./launcher enter appRAILS_ENV=production bundle exec script/discourse remap '/uploads' '/forum/uploads'"},{"id":"b44","type":"paragraph","html":"

注意：如果你的路径为/demo/forum 那么需要将以上内容中的/forum替换为/demo/forum，run 中还需要调整一个相对路径cd public/demo/forum && ln -s ../../uploads && ln -s ../../backups,因为是两级目录，这里需要注意一下，避免找不到静态文件。

","text":"注意：如果你的路径为/demo/forum 那么需要将以上内容中的/forum替换为/demo/forum，run 中还需要调整一个相对路径cd public/demo/forum && ln -s ../../uploads && ln -s ../../backups,因为是两级目录，这里需要注意一下，避免找不到静态文件。"},{"id":"b45","type":"heading","html":"

添加网络代理

","text":"添加网络代理"},{"id":"b46","type":"paragraph","html":"

env:
  ...
  http_proxy: http://xxxx
  https_proxy: http://xxxx
  no_proxy: \"127.0.0.1,localhost,.demo.com\"
  HTTPS_PROXY: http://xxxx
  HTTP_PROXY: http://xxxx
  NO_PROXY: \"127.0.0.1,localhost,.demo.com\"

","text":"12345678env: ... http_proxy: http://xxxx https_proxy: http://xxxx no_proxy: \"127.0.0.1,localhost,.demo.com\" HTTPS_PROXY: http://xxxx HTTP_PROXY: http://xxxx NO_PROXY: \"127.0.0.1,localhost,.demo.com\""},{"id":"b47","type":"heading","html":"

安装插件

","text":"安装插件"},{"id":"b48","type":"paragraph","html":"

hooks:
  before_exec:
    - exec: \"ulimit -v 2097152\"
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/discourse-oauth2-basic
          - git clone https://github.com/discourse/discourse-restricted-replies
          - git clone https://github.com/discourse/discourse-templates

","text":"12345678910hooks: before_exec: - exec: \"ulimit -v 2097152\" after_code: - exec: cd: $home/plugins cmd: - git clone https://github.com/discourse/discourse-oauth2-basic - git clone https://github.com/discourse/discourse-restricted-replies - git clone https://github.com/discourse/discourse-templates"},{"id":"b49","type":"heading","html":"

google object storage

","text":"google object storage"},{"id":"b50","type":"paragraph","html":"

官方文档

","text":"官方文档"},{"id":"b51","type":"paragraph","html":"

env:
  ...
  DISCOURSE_USE_S3: true
  DISCOURSE_S3_REGION: us-east1
  DISCOURSE_S3_INSTALL_CORS_RULE: false
  FORCE_S3_UPLOADS: 1
  DISCOURSE_S3_ENDPOINT: https://storage.googleapis.com
  DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey
  DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey
  DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev
  DISCOURSE_S3_BUCKET: falcoland-files
  #DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backup
  #DISCOURSE_BACKUP_LOCATION: s3

","text":"1234567891011121314env: ... DISCOURSE_USE_S3: true DISCOURSE_S3_REGION: us-east1 DISCOURSE_S3_INSTALL_CORS_RULE: false FORCE_S3_UPLOADS: 1 DISCOURSE_S3_ENDPOINT: https://storage.googleapis.com DISCOURSE_S3_ACCESS_KEY_ID: myaccesskey DISCOURSE_S3_SECRET_ACCESS_KEY: mysecretkey DISCOURSE_S3_CDN_URL: https://falcoland-files-cdn.falco.dev DISCOURSE_S3_BUCKET: falcoland-files #DISCOURSE_S3_BACKUP_BUCKET: falcoland-files/backup #DISCOURSE_BACKUP_LOCATION: s3"},{"id":"b52","type":"paragraph","html":"

其中 DISCOURSE_S3_CDN_URL 代表将 js 等资源也上传到云上，如果没有该配置只会上传文件。

","text":"其中 DISCOURSE_S3_CDN_URL 代表将 js 等资源也上传到云上，如果没有该配置只会上传文件。"},{"id":"b53","type":"paragraph","html":"

如果启用，还需要添加上传 js 等资源。每次编译都会上传。

","text":"如果启用，还需要添加上传 js 等资源。每次编译都会上传。"},{"id":"b54","type":"paragraph","html":"

hooks:
  after_assets_precompile:
    - exec:
        cd: $home
        cmd:
          - sudo -E -u discourse bundle exec rake s3:upload_assets
          # - sudo -E -u discourse bundle exec rake s3:expire_missing_assets  --trace 正常来说需要该步操作，但是目前执行会报错，可以手动在页面上删除。

","text":"12345678hooks: after_assets_precompile: - exec: cd: $home cmd: - sudo -E -u discourse bundle exec rake s3:upload_assets # - sudo -E -u discourse bundle exec rake s3:expire_missing_assets --trace 正常来说需要该步操作，但是目前执行会报错，可以手动在页面上删除。"},{"id":"b55","type":"heading","html":"

全局速率限制设置

","text":"全局速率限制设置"},{"id":"b56","type":"paragraph","html":"

关注速率限制有 3 个地方:

","text":"关注速率限制有 3 个地方:"},{"id":"b57","type":"list","html":"

是 web.ratelimited.template.yml
环境变量
网站 /admin/config/rate-limits

","text":"是 web.ratelimited.template.yml 环境变量网站 /admin/config/rate-limits"},{"id":"b58","type":"paragraph","html":"

环境变量

","text":"环境变量"},{"id":"b59","type":"paragraph","html":"

1
2
3

DISCOURSE_MAX_REQS_PER_IP_MODE: none
DISCOURSE_MAX_ADMIN_API_REQS_PER_MINUTE: 600000

","text":"123DISCOURSE_MAX_REQS_PER_IP_MODE: noneDISCOURSE_MAX_ADMIN_API_REQS_PER_MINUTE: 600000"},{"id":"b60","type":"heading","html":"

bitnami/discourse 使用

","text":"bitnami/discourse 使用"},{"id":"b61","type":"paragraph","html":"

文档可以查看 bitnami/discourse

","text":"文档可以查看 bitnami/discourse"},{"id":"b62","type":"paragraph","html":"

所有操作都需要在工作目录，开始前需要提前配置代理等信息

","text":"所有操作都需要在工作目录，开始前需要提前配置代理等信息"},{"id":"b63","type":"paragraph","html":"

cd /opt/bitnami/discourse
git config --global http.sslVerify false
export http_proxy=http://xxxxxxxxx:1080
export https_proxy=http://xxxxxxxxx:1080

","text":"1234cd /opt/bitnami/discoursegit config --global http.sslVerify falseexport http_proxy=http://xxxxxxxxx:1080export https_proxy=http://xxxxxxxxx:1080"},{"id":"b64","type":"heading","html":"

安装插件

","text":"安装插件"},{"id":"b65","type":"paragraph","html":"

1
2

RAILS_ENV=production bundle exec rake plugin:install repo=https://github.com/discourse/discourse-oauth2-basic
RAILS_ENV=production bundle exec rake assets:precompile

","text":"12RAILS_ENV=production bundle exec rake plugin:install repo=https://github.com/discourse/discourse-oauth2-basicRAILS_ENV=production bundle exec rake assets:precompile"},{"id":"b66","type":"heading","html":"

安装主题

","text":"安装主题"},{"id":"b67","type":"paragraph","html":"

echo \"redditish:
  url: https://github.com/discourse/discourse-redditish-theme
  add_to_all_themes: true\" | tee my_theme.yml > /dev/null
RAILS_ENV=production bundle exec rake themes:install > my_theme.yml
RAILS_ENV=production bundle exec rake themes:update assets:precompile

","text":"12345echo \"redditish: url: https://github.com/discourse/discourse-redditish-theme add_to_all_themes: true\" | tee my_theme.yml > /dev/nullRAILS_ENV=production bundle exec rake themes:install > my_theme.ymlRAILS_ENV=production bundle exec rake themes:update assets:precompile"},{"id":"b68","type":"paragraph","html":"

有可能安装失败，原因未知。

","text":"有可能安装失败，原因未知。"},{"id":"b69","type":"heading","html":"

API

","text":"API"},{"id":"b70","type":"paragraph","html":"

API 文档 https://docs.discourse.org/

","text":"API 文档 https://docs.discourse.org/"},{"id":"b71","type":"paragraph","html":"

Ruby API https://github.com/discourse/discourse_api

","text":"Ruby API https://github.com/discourse/discourse_api"},{"id":"b72","type":"paragraph","html":"

逆向 API https://meta.discourse.org/t/reverse-engineer-the-discourse-api/20576?silent=true

","text":"逆向 API https://meta.discourse.org/t/reverse-engineer-the-discourse-api/20576?silent=true"},{"id":"b73","type":"paragraph","html":"

查询所有的 Category

","text":"查询所有的 Category"},{"id":"b74","type":"paragraph","html":"

https://{host}/categories.json

","text":"1https://{host}/categories.json"},{"id":"b75","type":"paragraph","html":"

查询 subcatefory

","text":"查询 subcatefory"},{"id":"b76","type":"paragraph","html":"

1
2

https://{host}/c/{id}.json
https://{host}/c/10.json

","text":"12https://{host}/c/{id}.jsonhttps://{host}/c/10.json"},{"id":"b77","type":"paragraph","html":"

查询网站信息

","text":"查询网站信息"},{"id":"b78","type":"paragraph","html":"

https://{host}/about.json

","text":"1https://{host}/about.json"},{"id":"b79","type":"heading","html":"

网站设置

","text":"网站设置"},{"id":"b80","type":"paragraph","html":"

1.删除顶部 getting started
$\"Img\"$

","text":"1.删除顶部 getting started"},{"id":"b81","type":"paragraph","html":"

2.Summarize this topic button

","text":"2.Summarize this topic button"},{"id":"b82","type":"paragraph","html":"

这个功能默认是存在的，只是需要达到一个计算分数，具体详见：https://meta.discourse.org/t/summarize-this-topic-button/132790/17
$\"Img\"$

","text":"这个功能默认是存在的，只是需要达到一个计算分数，具体详见：https://meta.discourse.org/t/summarize-this-topic-button/132790/17"},{"id":"b83","type":"paragraph","html":"

3.外链新打开 tab 页
$\"Img\"$

","text":"3.外链新打开 tab 页"},{"id":"b84","type":"paragraph","html":"

Default other external links in new tab

","text":"Default other external links in new tab"},{"id":"b85","type":"heading","html":"

预安装插件列表

","text":"预安装插件列表"},{"id":"b86","type":"heading","html":"

数据库操作

","text":"数据库操作"},{"id":"b87","type":"paragraph","html":"

变更管理员邮箱

","text":"变更管理员邮箱"},{"id":"b88","type":"paragraph","html":"

SELECT * FROM users WHERE admin = true;


SELECT id, email FROM user_emails WHERE user_id = 1;--user@example.com


UPDATE user_emails SET email = 'user@example.com', updated_at = NOW() WHERE user_id = 1;

","text":"12345678SELECT * FROM users WHERE admin = true;SELECT id, email FROM user_emails WHERE user_id = 1;--user@example.comUPDATE user_emails SET email = 'user@example.com', updated_at = NOW() WHERE user_id = 1;"},{"id":"b89","type":"heading","html":"

备份

","text":"备份"},{"id":"b90","type":"paragraph","html":"

1.修改备份包内容

","text":"1.修改备份包内容"},{"id":"b91","type":"paragraph","html":"

1
2

gzip gamer-community-2025-04-09-052308-v20250321143553-1.tar.gz
tar -zczvf gamer-community-2025-04-09-052308-v20250321143553-1.tar.gz ./*

","text":"12gzip gamer-community-2025-04-09-052308-v20250321143553-1.tar.gztar -zczvf gamer-community-2025-04-09-052308-v20250321143553-1.tar.gz ./*"},{"id":"b92","type":"paragraph","html":"

2.导出/导入所有站点设置

","text":"2.导出/导入所有站点设置"},{"id":"b93","type":"paragraph","html":"

参考文档

","text":"参考文档"},{"id":"b94","type":"paragraph","html":"

rake site_settings:export > saved_settings.yml

rake site_settings:import < saved_settings.yml

","text":"1234rake site_settings:export > saved_settings.ymlrake site_settings:import < saved_settings.yml"},{"id":"b95","type":"paragraph","html":"

3.导入/导出类别

","text":"3.导入/导出类别"},{"id":"b96","type":"paragraph","html":"

1
2
3

rake export:category_structure
rake import:file[\"category-structure-export-2025-05-09-025650.json\"]

","text":"123rake export:category_structurerake import:file[\"category-structure-export-2025-05-09-025650.json\"]"},{"id":"b97","type":"heading","html":"

源码开发

","text":"源码开发"},{"id":"b98","type":"paragraph","html":"

本文是在 wsl 环境中配置，参考官方文档。

","text":"本文是在 wsl 环境中配置，参考官方文档。"},{"id":"b99","type":"paragraph","html":"

1
2

git clone https://github.com/discourse/discourse.git
cd discourse

","text":"12git clone https://github.com/discourse/discourse.gitcd discourse"},{"id":"b100","type":"paragraph","html":"

在开始前根据自己环境选择是否修改镜像仓库地址和增加代理，由于在公司内部网络限制，因此我在开始前有做以上两个操作，代理地址是添加在 docker run 中。

","text":"在开始前根据自己环境选择是否修改镜像仓库地址和增加代理，由于在公司内部网络限制，因此我在开始前有做以上两个操作，代理地址是添加在 docker run 中。"},{"id":"b101","type":"paragraph","html":"

d/boot_dev --init
    # wait while:
    #   - dependencies are installed,
    #   - the database is migrated, and
    #   - an admin user is created (you'll need to interact with this)

# In one terminal:
d/rails s

# And in a separate terminal
d/ember-cli

","text":"1234567891011d/boot_dev --init # wait while: # - dependencies are installed, # - the database is migrated, and # - an admin user is created (you'll need to interact with this)# In one terminal:d/rails s# And in a separate terminald/ember-cli"},{"id":"b102","type":"heading","html":"

主题开发

","text":"主题开发"},{"id":"b103","type":"paragraph","html":"

可以通过本地开发实时渲染更新到网站上，这种方式可以大大提高主题开发效率。具体文档详见：https://meta.discourse.org/t/install-the-discourse-theme-cli-console-app-to-help-you-build-themes/82950/1

","text":"可以通过本地开发实时渲染更新到网站上，这种方式可以大大提高主题开发效率。具体文档详见：https://meta.discourse.org/t/install-the-discourse-theme-cli-console-app-to-help-you-build-themes/82950/1"},{"id":"b104","type":"paragraph","html":"

通过 discourse_theme 命令可以将本地开发好的主题直接上传到网站上，同时还可以实时渲染看到更改效果！

","text":"通过 discourse_theme 命令可以将本地开发好的主题直接上传到网站上，同时还可以实时渲染看到更改效果！"},{"id":"b105","type":"list","html":"

首先安装 Ruby,通过Ruby Installer很容易安装
然后通过命令安装 discourse cli gem install discourse_theme
使用 cli
例如：创建discourse_theme new YOUR_DIR_NAME
实时渲染 discourse_theme watch YOUR_DIR_NAME

","text":"首先安装 Ruby,通过Ruby Installer很容易安装然后通过命令安装 discourse cli gem install discourse_theme 使用 cli例如：创建discourse_theme new YOUR_DIR_NAME实时渲染 discourse_theme watch YOUR_DIR_NAME"},{"id":"b106","type":"paragraph","html":"

.discourse_theme 配置信息可以参考我本地：

","text":".discourse_theme 配置信息可以参考我本地："},{"id":"b107","type":"paragraph","html":"

---
C:/Users/truman/Desktop/discourse-redditish-theme:
  url: https://gamertest.xxxx.org
  components: none
  theme_id: 16
api_keys:
  https://gamertest.xxxx.org:
  xxxxxxxxxxxxx

","text":"12345678---C:/Users/truman/Desktop/discourse-redditish-theme: url: https://gamertest.xxxx.org components: none theme_id: 16api_keys: https://gamertest.xxxx.org: xxxxxxxxxxxxx"},{"id":"b108","type":"paragraph","html":"

使用命令：discourse_theme watch .\\discourse-redditish-theme\\

","text":"使用命令：discourse_theme watch .\\discourse-redditish-theme\\"},{"id":"b110","type":"heading","html":"

components 开发

","text":"components 开发"},{"id":"b111","type":"paragraph","html":"

可以参考：https://github.com/discourse/discourse-profile-custom-link

","text":"可以参考：https://github.com/discourse/discourse-profile-custom-link"},{"id":"b112","type":"paragraph","html":"

settings.yml 用来设置配置信息

","text":"settings.yml 用来设置配置信息"},{"id":"b113","type":"paragraph","html":"

common/common.scss 设置公共样式

","text":"common/common.scss 设置公共样式"},{"id":"b114","type":"paragraph","html":"

javascripts/discourse/connectors 设置插槽入口

","text":"javascripts/discourse/connectors 设置插槽入口"},{"id":"b115","type":"paragraph","html":"

locales/en.yml 设置国际化

","text":"locales/en.yml 设置国际化"},{"id":"b116","type":"paragraph","html":"

javascripts/discourse/components 用来添加前端组件

","text":"javascripts/discourse/components 用来添加前端组件"},{"id":"b117","type":"paragraph","html":"

举个例子，这里开发一个调用后端 api 获取相应数据。

","text":"举个例子，这里开发一个调用后端 api 获取相应数据。"},{"id":"b118","type":"paragraph","html":"$20","text":"$21"},{"id":"b119","type":"heading","html":"

主题脚本

","text":"主题脚本"},{"id":"b120","type":"paragraph","html":"

可以都过脚本来插入按钮，隐藏功能，由于 discourse 前端路由问题，可以通过 plugin api 来修改部分内容。

","text":"可以都过脚本来插入按钮，隐藏功能，由于 discourse 前端路由问题，可以通过 plugin api 来修改部分内容。"},{"id":"b121","type":"paragraph","html":"

import { apiInitializer } from \"discourse/lib/api\";

export default apiInitializer((api) => {
  api.onPageChange(() =>{
      customFuntion();
  });

});

","text":"123456789import { apiInitializer } from \"discourse/lib/api\";export default apiInitializer((api) => { api.onPageChange(() =>{ customFuntion(); });});"},{"id":"b122","type":"paragraph","html":"

onPageChange 是在页面切换后触发。更多 api 详见连接

","text":"onPageChange 是在页面切换后触发。更多 api 详见连接"},{"id":"b123","type":"heading","html":"

配置信息

","text":"配置信息"},{"id":"b124","type":"paragraph","html":"

在主题中获取配置信息和插件存在差异，主题配置信息在settings.yml 文件中，在 template 和 gjs 中可以直接获取settings对象，不需要导入。

","text":"在主题中获取配置信息和插件存在差异，主题配置信息在settings.yml 文件中，在 template 和 gjs 中可以直接获取settings对象，不需要导入。"},{"id":"b125","type":"paragraph","html":"

template 中例子：

","text":"template 中例子："},{"id":"b126","type":"paragraph","html":"

{{log \"Theme settings:\" settings}}

","text":"1{{log \"Theme settings:\" settings}}"},{"id":"b127","type":"paragraph","html":"

js 代码块中例子：

","text":"js 代码块中例子："},{"id":"b128","type":"paragraph","html":"

1
2
3

get mappings() {
        console.log(\"Bullet points mappings:\", settings.bullet_points_mappings);
    }

","text":"123get mappings() { console.log(\"Bullet points mappings:\", settings.bullet_points_mappings); }"},{"id":"b129","type":"paragraph","html":"

更多用法详见官网文档

","text":"更多用法详见官网文档"},{"id":"b130","type":"paragraph","html":"

在settings.yml中不需要声明client: true, settings 信息测试仅能在 gjs 文件中使用。

","text":"在settings.yml中不需要声明client: true, settings 信息测试仅能在 gjs 文件中使用。"},{"id":"b131","type":"heading","html":"

打包

","text":"打包"},{"id":"b132","type":"paragraph","html":"

进去主题目录，压缩文件不含包文件夹名，还需要排除 git 目录。

","text":"进去主题目录，压缩文件不含包文件夹名，还需要排除 git 目录。"},{"id":"b133","type":"heading","html":"

插件开发

","text":"插件开发"},{"id":"b134","type":"paragraph","html":"

插件和主题的 components 有点类似，但部分使用又有点区别，可以首先参考discourse-plugin-skeleton 骨架项目创建一个插件项目。

","text":"插件和主题的 components 有点类似，但部分使用又有点区别，可以首先参考discourse-plugin-skeleton 骨架项目创建一个插件项目。"},{"id":"b135","type":"paragraph","html":"

开发文档：Developing Discourse Plugins - Part 1 - Create a basic plugin

","text":"开发文档：Developing Discourse Plugins - Part 1 - Create a basic plugin"},{"id":"b136","type":"paragraph","html":"

以下来解释一下项目目录：

","text":"以下来解释一下项目目录："},{"id":"b137","type":"paragraph","html":"$22","text":"1234567891011121314151617181920212223242526272829303132333435363738394041424344.├── Gemfile├── Gemfile.lock├── LICENSE├── README.md├── app│ └── controllers # 增加后端API 入口│ └── discourse_profile│ └── profile_controller.rb├── assets│ ├── javascripts│ │ └── discourse│ │ ├── components # 前端组件│ │ │ └── profile-link.js│ │ ├── connectors # 页面注入槽点│ │ │ ├── user-card-post-names # 槽点│ │ │ │ └── profile-link.hbs│ │ │ └── user-location-and-website # 槽点│ │ │ └── profile-link.hbs│ │ └── templates│ │ └── components│ │ └── profile-link.hbs # 页面模板文件│ └── stylesheets│ └── common│ └── profile.scss├── config│ ├── locales│ │ └── client.en.yml # 国际化│ ├── routes.rb # 路由配置│ └── settings.yml # 配置参数├── db├── eslint.config.mjs├── lib│ └── profile_link│ └── engine.rb├── package.json├── plugin.rb # 插件注册和配置的入口├── pnpm-lock.yaml├── spec│ └── system│ └── core_features_spec.rb├── stylelint.config.mjs└── test └── javascripts"},{"id":"b138","type":"heading","html":"

插件配置

","text":"插件配置"},{"id":"b139","type":"paragraph","html":"

在 plugin.rb 文件开头增加插件配置信息，主要用来声明插件信息。

","text":"在 plugin.rb 文件开头增加插件配置信息，主要用来声明插件信息。"},{"id":"b140","type":"paragraph","html":"

# name: discourse-profile
# about: Add Profile Link to User Profile
# version: 1.0.0
# authors: Truman
# url: https://xxxxx.xxxx.xxxxx

","text":"12345# name: discourse-profile# about: Add Profile Link to User Profile# version: 1.0.0# authors: Truman# url: https://xxxxx.xxxx.xxxxx"},{"id":"b141","type":"heading","html":"

配置信息

","text":"配置信息"},{"id":"b142","type":"paragraph","html":"

在 settings.yml 中设置插件可用配置信息，如下为我最近写的一个例子：

","text":"在 settings.yml 中设置插件可用配置信息，如下为我最近写的一个例子："},{"id":"b143","type":"paragraph","html":"

plugins:
  profile_link_enabled:
    default: true
    type: bool
    client: true
  profile_link_label:
    default: \"Truman Profile\"
    client: true
    type: text
  ......

","text":"1234567891011plugins: profile_link_enabled: default: true type: bool client: true profile_link_label: default: \"Truman Profile\" client: true type: text ......"},{"id":"b144","type":"paragraph","html":"

官网文档 plugins 为 plugin name ，但是国际化中还需要额外增加信息，我看很多插件都是使用 plugins，目前测试没有问题，存在在管理页面无法打开插件的设置页面，必须点设置才能修改。

","text":"官网文档 plugins 为 plugin name ，但是国际化中还需要额外增加信息，我看很多插件都是使用 plugins，目前测试没有问题，存在在管理页面无法打开插件的设置页面，必须点设置才能修改。"},{"id":"b145","type":"paragraph","html":"

如果想让前端获取该配置信息，一定要增加client: true，布尔值需要添加默认值

","text":"如果想让前端获取该配置信息，一定要增加client: true，布尔值需要添加默认值"},{"id":"b146","type":"paragraph","html":"

同时还需要在 plugin.rb 中启用，使用如下：

","text":"同时还需要在 plugin.rb 中启用，使用如下："},{"id":"b147","type":"paragraph","html":"

1
2

enabled_site_setting :profile_link_enabled

","text":"12enabled_site_setting :profile_link_enabled"},{"id":"b148","type":"paragraph","html":"

除此以外还需要初始化注册（非必须）

","text":"除此以外还需要初始化注册（非必须）"},{"id":"b149","type":"paragraph","html":"

after_initialize do
  # 注册设置
   settings = %w[
    label
    debug
  ]

  settings.each do |setting|
    SiteSetting.set(\"profile_link_#{setting}\", SiteSetting.defaults[\"profile_link_#{setting}\"] || nil)
  end
end

","text":"1234567891011after_initialize do # 注册设置 settings = %w[ label debug ] settings.each do |setting| SiteSetting.set(\"profile_link_#{setting}\", SiteSetting.defaults[\"profile_link_#{setting}\"] || nil) endend"},{"id":"b150","type":"paragraph","html":"

前端页面获取配置信息
js 中

","text":"前端页面获取配置信息js 中"},{"id":"b151","type":"paragraph","html":"

import Component from \"@glimmer/component\";
import { inject as service } from \"@ember/service\";

export default class ProfileLink extends Component {
    @service siteSettings;

    get linkLabel() {
        return this.siteSettings.profile_link_label;
    }
}

","text":"12345678910import Component from \"@glimmer/component\";import { inject as service } from \"@ember/service\";export default class ProfileLink extends Component { @service siteSettings; get linkLabel() { return this.siteSettings.profile_link_label; }}"},{"id":"b152","type":"paragraph","html":"

其中切记一定要增加@service siteSettings;,负责 js 和 hbs 中都无法获取配置信息。

","text":"其中切记一定要增加@service siteSettings;,负责 js 和 hbs 中都无法获取配置信息。"},{"id":"b153","type":"paragraph","html":"

模板文件 hbs 中

","text":"模板文件 hbs 中"},{"id":"b154","type":"paragraph","html":"

{{this.siteSettings.profile_link_label}}

","text":"1{{this.siteSettings.profile_link_label}}"},{"id":"b155","type":"paragraph","html":"

后端 rb 代码获取配置信息

","text":"后端 rb 代码获取配置信息"},{"id":"b156","type":"paragraph","html":"

SiteSetting.profile_link_label

","text":"1SiteSetting.profile_link_label"},{"id":"b157","type":"paragraph","html":"

这里再给一个最新版的配置信息 demo,获取配置信息一致，这种方式应该是最新推荐的，使用这种方式支持在管理页面直接访问设置页面。

","text":"这里再给一个最新版的配置信息 demo,获取配置信息一致，这种方式应该是最新推荐的，使用这种方式支持在管理页面直接访问设置页面。"},{"id":"b158","type":"paragraph","html":"

settings.yml

","text":"settings.yml"},{"id":"b159","type":"paragraph","html":"

category_resources:
  category_resources_enabled:
    default: true
    client: true
    description: \"启用分类资源边栏功能\"

","text":"12345category_resources: category_resources_enabled: default: true client: true description: \"启用分类资源边栏功能\""},{"id":"b160","type":"paragraph","html":"

client.en.yml

","text":"client.en.yml"},{"id":"b161","type":"paragraph","html":"

en:
  admin_js:
    admin:
      site_settings:
        categories:
          category_resources: \"Category Resources\"
  js:
    category_resources:
      title: Category Resources

","text":"12345678910en: admin_js: admin: site_settings: categories: category_resources: \"Category Resources\" js: category_resources: title: Category Resources"},{"id":"b162","type":"paragraph","html":"

不用再在 plugin.rb 中初始化配置信息。

","text":"不用再在 plugin.rb 中初始化配置信息。"},{"id":"b163","type":"heading","html":"

样式

","text":"样式"},{"id":"b164","type":"paragraph","html":"

在assets/stylesheets/common目录下增加自己插件的样式信息，要求为 scss

","text":"在assets/stylesheets/common目录下增加自己插件的样式信息，要求为 scss"},{"id":"b165","type":"paragraph","html":"

.user-card-location-and-website-outlet {
  margin-inline: 0.5em;

  .external-user-link {
    a {
      color: var(--primary);
      text-decoration: underline;
    }

    svg {
      margin-right: 0.25em;
    }
  }
}

","text":"1234567891011121314.user-card-location-and-website-outlet { margin-inline: 0.5em; .external-user-link { a { color: var(--primary); text-decoration: underline; } svg { margin-right: 0.25em; } }}"},{"id":"b166","type":"paragraph","html":"

同时还需要在 plugin.rb 中启用，使用如下：

","text":"同时还需要在 plugin.rb 中启用，使用如下："},{"id":"b167","type":"paragraph","html":"

register_asset \"stylesheets/common/profile.scss\"

","text":"1register_asset \"stylesheets/common/profile.scss\""},{"id":"b168","type":"heading","html":"

前端开发

","text":"前端开发"},{"id":"b169","type":"paragraph","html":"

前端代码都是在assets/javascripts/discourse/下，以下用…替代

","text":"前端代码都是在assets/javascripts/discourse/下，以下用…替代"},{"id":"b170","type":"paragraph","html":"

前端组件及模板

","text":"前端组件及模板"},{"id":"b171","type":"paragraph","html":"

ProfileLink 组件在.../components/下

","text":"ProfileLink 组件在.../components/下"},{"id":"b172","type":"paragraph","html":"

import Component from \"@glimmer/component\";
import { service } from '@ember/service';

export default class ProfileLink extends Component {
    @service siteSettings;

    get linkLabel() {
        return this.siteSettings.profile_link_label;
    }
}

","text":"1234567891011import Component from \"@glimmer/component\";import { service } from '@ember/service';export default class ProfileLink extends Component { @service siteSettings; get linkLabel() { return this.siteSettings.profile_link_label; }}"},{"id":"b173","type":"paragraph","html":"

以上写法为历史写法，可能存在告警，最新推荐将组件和模板写在一个 gjs 文件中,例如：

","text":"以上写法为历史写法，可能存在告警，最新推荐将组件和模板写在一个 gjs 文件中,例如："},{"id":"b174","type":"paragraph","html":"$23","text":"12345678910111213141516171819202122232425262728293031323334353637383940import Component from \"@glimmer/component\";import { inject as service } from \"@ember/service\";import { hbs } from \"ember-cli-htmlbars\";export default class CategoryResources extends Component { @service router; @service siteSettings; constructor() { super(...arguments); } get categoryResources() { try { .... } catch (error) { console.error(\"...\", error); return []; } } }"},{"id":"b175","type":"paragraph","html":"

前端注入点

","text":"前端注入点"},{"id":"b176","type":"paragraph","html":"

.../connectors/user-card-post-names/link.hbs

","text":".../connectors/user-card-post-names/link.hbs"},{"id":"b177","type":"paragraph","html":"

其中user-card-post-names 为 discourse 前端插槽，又称注入点。

","text":"其中user-card-post-names 为 discourse 前端插槽，又称注入点。"},{"id":"b178","type":"paragraph","html":"

link.hbs 例如：

","text":"link.hbs 例如："},{"id":"b179","type":"paragraph","html":"

<ProfileLink @user={{@outletArgs.user}}/>

","text":"1"},{"id":"b180","type":"paragraph","html":"

在源码中能发现更多的注入点：https://github.com/search?q=repo%3Adiscourse%2Fdiscourse+PluginOutlet+%40name%3D&type=code

","text":"在源码中能发现更多的注入点：https://github.com/search?q=repo%3Adiscourse%2Fdiscourse+PluginOutlet+%40name%3D&type=code"},{"id":"b181","type":"heading","html":"

后端开发

","text":"后端开发"},{"id":"b182","type":"paragraph","html":"

在 Discourse 插件开发中，使用 Engine 定义自己插件空间，隔离一些信息。

","text":"在 Discourse 插件开发中，使用 Engine 定义自己插件空间，隔离一些信息。"},{"id":"b183","type":"paragraph","html":"

在 plugin.rb 中引入定义,定义模块

","text":"在 plugin.rb 中引入定义,定义模块"},{"id":"b184","type":"paragraph","html":"

require_relative \"lib/profile_link/engine\"

module ::DiscourseProfile
  PLUGIN_NAME = \"discourse-profile\"
end

","text":"12345require_relative \"lib/profile_link/engine\"module ::DiscourseProfile PLUGIN_NAME = \"discourse-profile\"end"},{"id":"b185","type":"paragraph","html":"

engine.rb

","text":"engine.rb"},{"id":"b186","type":"paragraph","html":"

# frozen_string_literal: true

module ::DiscourseProfile
  class Engine < ::Rails::Engine
    engine_name PLUGIN_NAME
    isolate_namespace DiscourseProfile
  end
end

","text":"12345678# frozen_string_literal: truemodule ::DiscourseProfile class Engine < ::Rails::Engine engine_name PLUGIN_NAME isolate_namespace DiscourseProfile endend"},{"id":"b187","type":"paragraph","html":"

在config/routes.rb中声明路由

","text":"在config/routes.rb中声明路由"},{"id":"b188","type":"paragraph","html":"

# frozen_string_literal: true

DiscourseProfile::Engine.routes.draw do
  get \"/profile_link/:user_id\" => \"profile#show\", as: :profile_link
end

Discourse::Application.routes.draw do
  mount ::DiscourseProfile::Engine, at: \"profile_link\"
end

","text":"123456789# frozen_string_literal: trueDiscourseProfile::Engine.routes.draw do get \"/profile_link/:user_id\" => \"profile#show\", as: :profile_linkendDiscourse::Application.routes.draw do mount ::DiscourseProfile::Engine, at: \"profile_link\"end"},{"id":"b189","type":"paragraph","html":"

这里声明了一个 get 请求/profile_link/:user_id,后端对应放在在 controllers 中

","text":"这里声明了一个 get 请求/profile_link/:user_id,后端对应放在在 controllers 中"},{"id":"b190","type":"paragraph","html":"

例如app/controllers/discourse-profile/profile_cpmtroller.rb

","text":"例如app/controllers/discourse-profile/profile_cpmtroller.rb"},{"id":"b191","type":"paragraph","html":"

module DiscourseProfile
  class ProfileController < ::ApplicationController
    requires_plugin DiscourseProfile::PLUGIN_NAME

    def show
      if SiteSetting.profile_link_debug
        Rails.logger.info \"Processing profile request for user_id: #{params[:user_id]}\"
      end

      raise Discourse::InvalidAccess.new unless current_user


      user = User.find_by(id: params[:user_id])
      raise Discourse::NotFound unless user

      result = fetch_profile(user)



      render json: result
    end

    private

    def fetch_profile(user)
      {
        profile_url: 'test_url'
        username: user.username,
        nid: nid
      }
    end
  end
end

","text":"123456789101112131415161718192021222324252627282930313233module DiscourseProfile class ProfileController < ::ApplicationController requires_plugin DiscourseProfile::PLUGIN_NAME def show if SiteSetting.profile_link_debug Rails.logger.info \"Processing profile request for user_id: #{params[:user_id]}\" end raise Discourse::InvalidAccess.new unless current_user user = User.find_by(id: params[:user_id]) raise Discourse::NotFound unless user result = fetch_profile(user) render json: result end private def fetch_profile(user) { profile_url: 'test_url' username: user.username, nid: nid } end endend"}],"source":"$0:f:0:1:0:props:children:props:children:1:props:children:props:children:props:children:0:props:sources:408","originalUrl":"http://blog.trumandu.top/2025/06/07/discourse-%E8%B0%83%E7%A0%94%E7%AC%94%E8%AE%B0/","excerpt":"插播一条广告，专业承接 discourse 开发，包含不限于主题，插件等功能自定义开发，需要的可以关注我的公众号，私信我。最近一个月的工作都集中在公司要搭建一个 Gamer Community 上，经过多个角度，多种开源，商业方案对比，最终选择了 discourse。多说一句对于一个论坛技术选型，以前没有这方面的储备，最终的选择也是 AI 推荐的。领导下发任务用 AI 拆分，作为员工的我们"},"shouldTranslate":true}],"$L24"]}]