WeKan Snap 实战指南用snap run wekan.problems在命令行读取 Admin Panel 的 Problems 状态总览【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekan本篇围绕 WeKan 的 Snap 命令行问题诊断 功能展开在 snap 包上Admin Panel → Problems 的Status总览除了网页端查看外还可以直接从服务器命令行以纯文本读出让只持有服务器snap权限、但没有 Admin Panel 访问权限的运维管理员也能掌握系统健康状况。读完后你将掌握wekan.problems全部子命令的用法、输出的各部分含义以及背后的实现链路——命令如何直连 27019 端口的数据库、如何从持久化状态集合读取“迁移/修复进行中”信息以及为什么登录页检查必须在 snap 环境中执行。功能定位没有 Admin Panel 权限也能看到系统状态该功能的设计初衷写在功能文档里在snap上Admin Panel → Problems 的Status总览同样可以以纯文本形式从服务器命令行获得因此一个拥有服务器snap访问权限的管理员无需被授予 Admin Panel 访问权限即可读取该总览。实现上有两个关键特性直连实时数据库命令通过 MongoDB 线协议wire protocol直接读取正在运行的数据库MongoDB 与 FerretDB v1/SQLite 都讲这套协议snap 同一时刻只运行其中之一均监听端口 27019。它使用 snap 内置的 Node.js 和mongodb驱动不需要mongosh只读命令只读取绝不修改任何数据。命令一览文档给出的完整命令集如下snap run wekan.problems # 完整 Status 总览默认 snap run wekan.problems migrations # 只看迁移 / 修复进度 snap run wekan.problems login # 只看登录页 Must be logged in 检查 snap run wekan.problems broken-cards # 只看损坏卡片计数 snap run wekan.problems cpu # 机器 CPU 负载 / 核心数不需要数据库 snap run wekan.problems help其中migrations和repairs是同一个“进行中列表”的别名。这些子命令在 snapcraft.yaml 中注册为独立 appproblems: command: ./bin/wekan-problems plugs: [network, network-bind]输出内容完整 Status 总览默认status输出形如文档示例Product name Problems — Status Database: mongodb://127.0.0.1:27019/wekan In progress: - Database migration (toFerretDB) — migrating: cards (3/30 collections) - Board># Load the snap settings so the login-page checks see the SAME configuration WeKan # runs with — ROOT_URL, LDAP_ENABLE, DATABASE, etc. if [ -r $SNAP/bin/wekan-read-settings ]; then . $SNAP/bin/wekan-read-settings /dev/null 21 || true fi env NODE_PATH$SNAP/programs/server/node_modules \ $SNAP/bin/node $SNAP/bin/wekan-problems.mjs $注释说明了历史动机如果不加载wekan-read-settings命令会读到空process.env即使已经snap set wekan root-url...报告也会误报 ROOT_URL “未设置”。源码中的额外增值双副本数据提示从源码结构看bash 包装还包含文档示例之外的一个板块在status/databases即默认模式下它会在末尾额外打印 “Databases on this machine”见 wekan-problems通过database-role --why报告当前服务的是哪份数据并检查$SNAP_COMMON下同时存在 MongoDB 的WiredTiger文件与 FerretDB 的files/db/*.sqlite。若两份副本同时存在会提示这是迁移后的正常状态并给出database-compare/database-merge命令指引在尚未包含这两个命令的旧版本上则提示先snap refresh。该板块同样只读、不启动也不写入任何内容专门回答“我看到的到底是哪一份数据”这类问题。使用建议小结只读服务器上排查“登录页 Must be logged in”优先snap run wekan.problems login重点看root-url与migration-in-progress两项页面整体卡顿cpumigrations组合使用判断是否为迁移/修复把 CPU 打满或 FerretDB v1 后端饱和关注数据完整性默认总览中的 Broken cards 计数或单独broken-cards需要跨库排障时用第二个参数或WEKAN_PROBLEMS_URL显式指定目标数据库地址。【免费下载链接】wekanThe Open Source kanban, built with Meteor. GitHub issues/PRs are only for FLOSS Developers, not for support, support is at https://wekan.fi/commercial-support/ . PR source translation to imports/i18n/data/en.i18n.json, other translations at https://app.transifex.com/wekan/wekan项目地址: https://gitcode.com/GitHub_Trending/we/wekan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考