ImgLink 插件用于 Discourse (托管图片工作流程 + 管理员诊断)

自定义 插件
1

摘要

Discourse 插件的 ImgLink 媒体上传集成，支持作用域 API 密钥、重试处理和管理员诊断功能。

仓库链接

https://github.com/imglink12x/discourse-plugin

安装指南

  1. SSH 进入您的 Discourse 容器：

  2. 将插件添加到您的 app.yml：

  3. 重建容器：

  4. 在管理员设置中配置您的 ImgLink API 密钥（见下文配置部分）

如需详细设置：https://imglink.cc/tools/forum-plugins

功能

  • 从编辑器直接上传 — 直接从 Discourse 帖子编辑器上传图片

  • 作用域 API 密钥 — 使用有限范围的凭证；没有完全账户访问权限

  • 直接链接和查看器链接 — 返回直接的 CDN 链接和图片查看器 URL

  • 重试 + 幂等性 — 针对不稳定连接的自动重试逻辑；防止重复上传

  • 管理员诊断 — 内置健康检查，用于验证 API 身份验证、连接性和上传权限

  • BBCode 输出 — 用于嵌入帖子的自动 BBCode 格式化

  • 错误日志记录 — 用于解决上传失败问题的详细日志

配置

步骤 1：创建 ImgLink API 密钥

  1. 登录 ImgLink (https://imglink.cc)

  2. 导航到 设置 → API 密钥

  3. 创建一个具有以下作用域的新密钥：

    • upload:create

    • image:delete（可选，用于清理工作流程）

  4. 复制 API 密钥

步骤 2：添加到 Discourse 管理设置

  1. 前往 管理 → 设置 → 插件

  2. 滚动到 ImgLink 设置

  3. 将您的 API 密钥粘贴到 imglink_api_key 字段中

4.（可选）如果使用自定义 ImgLink 实例，设置 imglink_api_endpoint

  1. 保存

步骤 3：运行诊断

  1. 前往 管理 → 插件 → ImgLink 设置

  2. 点击 “测试连接” 以验证您的配置

  3. 您应该看到 “✓ 连接成功”

设置

设置名称 类型 默认值 描述
imglink_api_key 字符串 (空) 您的 ImgLink API 密钥，具有 upload:create 作用域
imglink_api_endpoint 字符串 https://imglink.cc/api/v1 ImgLink API 基础 URL（除非自托管，否则请保留默认值）
imglink_max_retries 整数 3 失败上传的重试尝试次数
imglink_retry_delay 整数 1000 重试尝试之间的等待毫秒数
imglink_timeout_ms 整数 30000 上传请求超时（30 秒）
imglink_enable_diagnostics 布尔值 true 启用管理员诊断工具和日志
imglink_enable_direct_links 布尔值 true 返回直接 CDN 链接，而不是查看器包装的链接

版本兼容性： Discourse 2.8+ | 最后更新时间： 2026 年 3 月 | 支持： https://imglink.cc/tools/forum-plugins

2

您为什么为这个主题选择这些标签？选择随机标签并不能让您的插件看起来特别值得信赖。

另外，大多数链接都无法打开：


设置在哪里？通常，我可以在配置文件夹中的设置文件中看到它们，例如：

2 个赞
5

您好，@A_Richards，我移除了您帖子上的标签，因为它们是垃圾信息且不相关。我还查看了代码，该插件没有正确设置以具有如上所述的可配置设置。

我建议您从这里开始编辑您的插件，使其更好：

2 个赞