Teams for Linux 安装完全指南：软件仓库、发行版包与手动安装全攻略

• 桌面应用
• 即时通讯

导读

本文面向所有希望在 Linux 桌面环境使用 Microsoft Teams 的用户，系统讲解非官方 Teams for Linux 客户端的全部安装途径——从官方维护的 deb/rpm 软件仓库、AUR、Snap、Flatpak 等发行版渠道，到 AppImage、deb、rpm、tar.gz 手动安装，并覆盖首次启动配置、常用命令行参数（多实例、调试模式）与常见安装故障排查。读完本文，你将能够根据发行版和需求选择最合适的安装方式，并正确完成初始配置与排障。

Teams for Linux 是一个封装了 Teams Web 版本的 Electron 原生桌面应用，在 Linux 上增强了系统通知、托盘集成、自定义背景、屏幕共享与多账户配置等体验。其安装入口分散在多个渠道，本文以 docs-site/docs/installation.md 为骨架，结合仓库源码与打包配置，给出完整、可复制的实操方案。

安装方式总览与选择建议

Teams for Linux 没有统一的安装包，而是面向不同发行版提供了多套安装途径，大体可以分为三类：

• 官方软件仓库（deb/rpm）：推荐首选，由项目维护者与社区成员共同维护，能随 GitHub Release 发布即时更新；
• 发行版专属渠道：Arch 的 AUR、Ubuntu 的 Pacstall、Vylen Linux 的 emerald、Snap Store、Flathub，与各发行版的包管理习惯深度集成；
• 手动安装：从 GitHub Releases 下载 AppImage、deb、rpm 或 tar.gz，适合无法使用上述渠道或需要精确控制版本的场景。

不同渠道的更新节奏差异明显。仓库中的 发布流程文档 明确记录了各渠道的更新频率：

如果你不希望频繁收到更新通知，选择 Flatpak 或 Snap stable 会更稳妥；反之，追求最新功能可选用 beta 通道或随 Release 发布的仓库渠道。

快速安装：官方软件仓库（推荐）

项目维护了专用的 deb 与 rpm 软件仓库（由社区成员托管），这是多数发行版用户的首选方式，安装与升级都由系统包管理器统一管理。

Debian / Ubuntu

在基于 apt 的系统上，通过 deb822 格式的源文件接入官方仓库：

sudo mkdir -p /etc/apt/keyrings sudo wget -qO /etc/apt/keyrings/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc sh -c 'echo "Types: deb URIs: https://repo.teamsforlinux.de/debian/ Suites: stable Components: main Signed-By: /etc/apt/keyrings/teams-for-linux.asc Architectures: amd64" | sudo tee /etc/apt/sources.list.d/teams-for-linux-packages.sources' sudo apt update && sudo apt install teams-for-linux

仓库中的 package.json 定义了 deb 包的运行时依赖，安装时 apt 会自动解析这些依赖，包括libgtk-3-0、libnotify4、libnss3、libxss1、libxtst6、xdg-utils、libatspi2.0-0、libuuid1、libsecret-1-0、libgbm1以及libasound2t64 | libasound2；此外还推荐安装libappindicator3-1（用于系统托盘）与fido2-tools（用于硬件安全密钥）。如果安装时报缺少依赖，通常是这些基础库未满足，可用sudo apt-get install -f自动修复。

RHEL / Fedora / CentOS

基于 dnf/rpm 的系统通过导入 GPG 公钥并添加 yum 仓库文件完成接入：

curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc sudo rpm --import /tmp/teams-for-linux.asc sudo curl -1sLf -o /etc/yum.repos.d/teams-for-linux.repo https://repo.teamsforlinux.de/rpm/teams-for-linux.repo sudo dnf install teams-for-linux

rpm 包的依赖定义同样在 package.json 中，包括gtk3、libnotify、nss、libXScrnSaver、libXtst（或libXtst6）、xdg-utils、at-spi2-core、libuuid（或libuuid1），构建时以 SHA256 摘要签名，并额外推荐fido2-tools。

Beta 通道（预发布版本）

新版本会先发布到beta通道，经过数天测试后才提升到stable。希望抢先体验预发布版本、帮助项目提前验证的用户可以跟随 beta 通道。

Debian/Ubuntu使用与 stable 相同的源，仅将Suites改为beta：

sudo mkdir -p /etc/apt/keyrings sudo wget -qO /etc/apt/keyrings/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc sh -c 'echo "Types: deb URIs: https://repo.teamsforlinux.de/debian/ Suites: beta Components: main Signed-By: /etc/apt/keyrings/teams-for-linux.asc Architectures: amd64" | sudo tee /etc/apt/sources.list.d/teams-for-linux-packages.sources' sudo apt update && sudo apt install teams-for-linux

RHEL/Fedora/CentOS使用独立的 beta 仓库文件：

curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc sudo rpm --import /tmp/teams-for-linux.asc sudo curl -1sLf -o /etc/yum.repos.d/teams-for-linux-beta.repo https://repo.teamsforlinux.de/rpm-beta/teams-for-linux-beta.repo sudo dnf install teams-for-linux

要回到 stable 版本：Debian/Ubuntu 用户把Suites: beta改回Suites: stable即可；RHEL/Fedora/CentOS 用户删除/etc/yum.repos.d/teams-for-linux-beta.repo并从 stable 仓库重新安装。值得注意的是，项目发布节奏并非固定周期，而是按变更的紧急程度批量发布：安全漏洞与核心功能回归（通话、登录、屏幕共享）会立即发布修复，普通功能累积到有意义的规模后以周或双周为单位发布，详见 发布流程文档。

发行版专属安装渠道

Arch Linux（AUR）

Arch 用户可通过 AUR 助手或手动构建安装：

# 使用 yay yay -S teams-for-linux # 使用 paru paru -S teams-for-linux # 手动构建 AUR 包 git clone https://aur.archlinux.org/teams-for-linux.git cd teams-for-linux makepkg -si

Ubuntu（Pacstall）

Pacstall 是面向 Ubuntu 的类 AUR 包管理器，可安装teams-for-linux-deb包：

# 先安装 Pacstall（如果尚未安装） sudo bash -c "$(curl -fsSL https://pacstall.dev/q/install)" # 安装 Teams for Linux pacstall -I teams-for-linux-deb

Vylen Linux

Vylen 用户可直接使用其自带包管理器：

sudo emerald install teams-for-linux

Snap Store

Snap 包以严格沙箱（confinement: strict）方式运行，package.json 中声明了audio-record、camera、hardware-observe、network-bind、network-manager-observe、removable-media、screen-inhibit-control、system-observe、upower-observe等接口（plugs），确保通话、摄像头、屏幕共享、电源状态监测等功能在沙箱内可用：

sudo snap install teams-for-linux

如 发布流程文档 所述，Snap stable 属于更新较慢的渠道，需要在 candidate 上测试后手动提升；喜欢稳定少打扰的用户可以选它。

Flathub

Flatpak 用户从 Flathub 安装：

flatpak install flathub com.github.IsmaelMartinez.teams_for_linux

Flathub Beta 通道（预发布）

预发布版本会先发布到 Flathub 的 beta remote，之后再进入 stable 构建。项目维护者没有可用的 Linux 桌面环境，因此沙箱与权限相关的改动无法由维护者自行测试，只能依赖 Flathub 构建机器人构建——跟随 beta remote 是 Flatpak 用户能为项目做的最有价值的测试工作。

flatpak remote-add --if-not-exists flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo flatpak install flathub-beta com.github.IsmaelMartinez.teams_for_linux//beta

重要提醒：beta 构建是同一应用 ID 下的独立分支，会与 stable 版本并存安装而非替换。这意味着启动方式需要特别注意——桌面启动器与不带分支的flatpak run com.github.IsmaelMartinez.teams_for_linux启动的都是 stable 构建。要真正测试预发布版本，必须显式指定 beta 分支：

flatpak run com.github.IsmaelMartinez.teams_for_linux//beta

回到 stable 只需移除 beta 分支：

flatpak uninstall com.github.IsmaelMartinez.teams_for_linux//beta

如果安装时报找不到应用，说明当前没有已发布的 beta 构建——beta remote 只在预发布版本测试期间携带构建，此时请改用上面的 stable 安装命令，等下一次发布后再试。beta remote 承载的仍是待验证的预发布与打包变更，可能会遇到偶发问题；遇到问题请到项目 Issues 反馈并注明你正在使用 beta remote。

手动安装

从 GitHub Releases 下载

1. 前往项目的 GitHub Releases 页面；
2. 根据系统选择对应安装包：
   • AppImage— 通用 Linux 包，一次下载到处运行；
   • deb— Debian/Ubuntu 包；
   • rpm— Red Hat/Fedora 包；
   • snap— 通用 snap 包；
   • tar.gz— 便携归档，无需安装即可运行。

从 package.json 的构建配置可以看到，每次构建会同时产出rpm、deb、tar.gz、AppImage四种 Linux 目标，并支持 x64、armv7l、arm64 三种架构；Snap 与 macOS、Windows 包由单独的脚本构建，因此各平台用户都能找到对应产物。

各包安装方式

Debian/Ubuntu（.deb）

sudo dpkg -i teams-for-linux_*.deb sudo apt-get install -f # 如依赖缺失则自动修复

Red Hat/Fedora（.rpm）

# Fedora sudo dnf install teams-for-linux_*.rpm # RHEL/CentOS sudo rpm -i teams-for-linux_*.rpm

AppImage

# 赋予执行权限 chmod +x teams-for-linux_*.AppImage # 直接运行 ./teams-for-linux_*.AppImage # 如需更好的桌面集成，可安装 AppImageLauncher

AppImage 是自包含的可执行文件，无需系统级安装，卸载时删除文件即可。为了更好的桌面集成（自动生成菜单项与文件关联），推荐搭配 AppImageLauncher 使用。

便携安装（tar.gz）

# 解压 tar -xzf teams-for-linux_*.tar.gz # 运行 cd teams-for-linux/ ./teams-for-linux

首次启动与初始配置

快速上手

安装完成后按三步即可开始使用：

1. 启动应用：

   teams-for-linux

2. 登录你的 Microsoft Teams 账户；
3. 按需创建~/.config/teams-for-linux/config.json进行配置。

初始配置

对于基本使用，无需任何配置，开箱即用。需要高级功能时，先创建配置目录：

mkdir -p ~/.config/teams-for-linux/

基础配置示例：

{ "minimizeToTray": true, "startInTray": false, "enableDesktopNotifications": true }

从源码实现看，配置加载发生在 app/config/index.js：应用会依次尝试读取系统级配置/etc/teams-for-linux/config.json与用户级配置<userData>/config.json，二者深度合并，用户配置优先于系统配置（适合企业批量下发默认策略、用户再覆盖的场景）；若两者都不存在则回退到默认值。配置解析由 yargs 完成，同一份 schema 同时支撑命令行参数与config.json两种输入方式。

关于配置文件的位置，不同安装类型存放路径不同，配置指南 中给出的完整对应关系为：

• 普通安装（deb/rpm/AUR 等）：~/.config/teams-for-linux/config.json
• Snap：~/snap/teams-for-linux/current/.config/teams-for-linux/config.json
• Flatpak：~/.var/app/com.github.IsmaelMartinez.teams_for_linux/config/teams-for-linux/config.json

配置系统的完整选项清单由 app/config/options.js 维护（它是配置 schema 的单一事实来源），并通过脚本npm run generate-config-docs生成文档，详见 配置选项参考 与交互式 配置浏览器。注意：部分早期扁平命名（如appTitle、class）已按 ADR-025 约定迁移到嵌套命名空间（如app.title、window.class），新旧名称在过渡期内仍兼容，建议新配置优先使用嵌套写法。

命令行选项

基本用法

# 标准启动 teams-for-linux # 使用自定义配置目录 teams-for-linux --user-data-dir=/path/to/custom/profile

--user-data-dir是 Electron/Chromium 标准开关。在 app/index.js 中，应用启动时会读取app.getPath("userData")作为配置根目录，因此指定不同的--user-data-dir即可让每个实例拥有完全独立的配置、缓存与会话数据。

多实例（工作与个人账号分离）

# 工作账号 teams-for-linux --user-data-dir=~/.config/teams-work --class=teams-work # 个人账号 teams-for-linux --user-data-dir=~/.config/teams-personal --class=teams-personal

--class参数用于设置窗口的 WM_CLASS 属性。从 app/startup/commandLine.js 的实现可以看到，该值会通过app.setName()与app.setDesktopName()同时作用于 X11 的 WM_CLASS 与 Wayland 的 wayland_app_id，从而影响窗口管理器识别、任务切换器外观与 dock/任务栏分组——这正是多个实例在桌面上彼此可区分的关键。多实例还支持--appIcon自定义托盘/窗口图标、--appTitle自定义窗口标题与托盘提示（默认值 "Microsoft Teams"），详细配置可参考 多实例指南。

调试模式

# 启用调试级别日志 teams-for-linux --logConfig='{"level":"debug"}' # 显示开发者工具并开启 Electron 日志 ELECTRON_ENABLE_LOGGING=true teams-for-linux

--logConfig控制 electron-log 的日志输出。从 app/config/options.js 的定义看，其默认值为{"transports":{"console":{"level":"info"},"file":{"level":false}}}——即默认只输出 info 级别到控制台、不写文件。若要完整打开文件日志，可写成：

teams-for-linux --logConfig='{"transports":{"console":{"level":"debug"},"file":{"level":"debug"}}}'

日志级别可选error、warn、info、verbose、debug、silly，设为false可关闭对应传输通道。更多日志配置细节可参考 日志配置文档。

安装故障排查

常见问题

包依赖缺失

# Ubuntu/Debian — 修复缺失依赖 sudo apt-get install -f # Fedora — 安装缺失包 sudo dnf install missing-package-name

音频不工作

# 检查 PulseAudio 状态 pulseaudio --check # 重启 PulseAudio pulseaudio --kill && pulseaudio --start

权限问题（麦克风/摄像头）

# 将用户加入 audio 组（麦克风） sudo usermod -a -G audio $USER # 将用户加入 video 组（摄像头） sudo usermod -a -G video $USER # 注销并重新登录使改动生效

软件仓库问题

GPG 密钥问题

# 重新导入仓库密钥 curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc sudo rpm --import /tmp/teams-for-linux.asc # 适用于 RPM 系

网络/代理问题

# 企业代理环境 export https_proxy=http://proxy.company.com:8080

值得一提的是，app/startup/commandLine.js 也支持在config.json中设置proxyServer项，应用会通过proxy-server开关把代理配置注入 Chromium，适合无法使用系统代理的桌面场景；若仍无法联网，可结合 故障排查指南 进一步定位。

卸载

不同安装方式对应不同的卸载命令，完整的逐步卸载流程（含软件仓库、签名密钥与用户数据的清理）请参考 卸载指南。需要特别注意：卸载应用不会删除用户数据与配置，如需彻底清理，普通安装的配置目录位于~/.config/teams-for-linux，Snap 位于~/snap/teams-for-linux/current/.config/teams-for-linux/，Flatpak 位于~/.var/app/com.github.IsmaelMartinez.teams_for_linux/config/teams-for-linux，删除即不可恢复。

安装后的下一步

完成安装后，推荐继续阅读以下文档，充分发挥 Teams for Linux 的能力：

1. 配置指南 — 定制 Teams for Linux 的全部设置；
2. 多实例指南 — 分离工作与个人账号；
3. 屏幕共享指南 — 配置屏幕捕获与共享缩略图；
4. 故障排查指南 — 常见问题与解决方案；
5. 卸载指南 — 彻底移除应用与残留数据；
6. 完整文档索引 — 所有文档入口。

源码级参考

本文涉及的关键实现均可直接在仓库中验证：

• package.json — 各发行版包（deb/rpm/snap）的依赖、接口与构建目标定义；
• app/index.js — 用户数据目录解析、系统级/用户级配置加载入口、E2E 临时目录支持；
• app/startup/commandLine.js —--class的 WM_CLASS 设置、代理与 GPU 开关注入、Wayland 自动配置；
• app/config/index.js — 系统/用户配置合并、yargs 解析、配置文件热监控；
• app/config/options.js — 全部配置选项的单一事实来源（含默认值、类型、弃用提示）；
• app/appConfiguration/index.js — 配置路径、启动配置与持久化 store 的管理。

• 桌面应用
• 即时通讯