Mattermost: 使用mmctl进行高级Mattermost管理

本文档属于入门指南指南的一部分。您可以在此处查看完整指南：如何开始使用Mattermost。

欢迎查阅 Stackhero 文档

Stackhero 提供面向生产环境的 Mattermost cloud 解决方案，专为无缝协作和强大数据保护而设计。主要优势包括：

• 支持无限用户和频道，助力团队自由扩展。
• 默认集成专属的SMTP 邮件服务器，无额外限制。
• 您可完全掌控自己的域名，并自动通过HTTPS加密（例如 https://chat.your-company.com）。
• 一键式轻松完成更新，无需繁琐操作。
• 在专属私有基础设施上实现高性能与高级安全性：您的数据始终隔离且保密。
• 提供🇪🇺 欧洲和🇺🇸 美国区域的托管服务。

您只需几分钟即可快速上手。Stackhero 全面负责 Mattermost cloud hosting 的部署、安全与运维管理，为您提供安全、可扩展的协作平台，极大简化操作流程。

对于想要深入了解的用户，mmctl CLI提供了强大的工具来管理和配置您的Mattermost实例。您可以在官方文档中找到更多详细信息：https://docs.mattermost.com/manage/mmctl-command-line-tool.html。

使用CLI mmctl与Mattermost

您可以选择在计算机上安装mmctl或使用Docker运行它。我们推荐使用Docker。要启动一个带有交互式bash shell的容器，您可以运行：

docker run -it mattermost/mattermost-team-edition:latest /bin/bash

要登录，请通过运行以下命令与您的服务器建立连接：

mmctl auth login -n stackhero https://<XXXXXX>.stackhero-network.com

系统会提示您输入Mattermost凭据。登录后，您可以使用mmctl CLI执行各种管理任务。

如果您使用双因素认证并遇到“could not initiate client: Invalid MFA token”错误，请通过运行以下命令包含您的MFA令牌（来自MFA应用的6位代码）：

mmctl auth login -n stackhero --mfa-token <XXXXXX> https://<XXXXXX>.stackhero-network.com

成功认证后，您可以使用以下命令列出所有Mattermost用户：

mmctl user list

使用mmctl删除Mattermost用户

警告 请谨慎：此操作将永久删除用户及其所有相关数据，无法恢复。

虽然您可以从Mattermost系统控制台禁用用户，但删除必须通过mmctl CLI进行。要删除用户，请运行：

mmctl user delete [email protected]

如果您遇到“Permanent user deletion feature is not enabled. Please contact your System Administrator”错误，请通过以下命令启用API用户删除支持：

mmctl config set ServiceSettings.EnableAPIUserDeletion true

使用mmctl删除Mattermost频道

您可以使用mmctl CLI删除频道。

警告 请谨慎：此操作将永久删除频道及其所有数据，无法恢复。

要删除频道，请用您的具体值替换<TEAM>和<CHANNEL>并执行：

mmctl channel delete <TEAM>:<CHANNEL>

如果您遇到Permanent channel deletion feature is not enabled. Please contact your System Administrator.错误，请通过运行以下命令启用此功能：

mmctl config set ServiceSettings.EnableAPIChannelDeletion true