在 iOS 和 Android 上将邮箱安装为 PWA

TrekMail 网页邮箱提供响应式手机布局，并可在支持的浏览器中安装为渐进式网页应用 (PWA)。安装后会获得主屏幕或桌面快捷方式和独立窗口，但邮箱不会因此变成离线邮件客户端。

在移动浏览器中使用网页邮箱

打开 trekmail.net/webmail/ 或服务商的品牌网页邮箱 URL，然后使用邮箱地址和邮箱密码登录。

在窄屏幕上：

• 文件夹和邮箱侧边栏会折叠，让消息列表使用全部宽度。
• 打开消息后，消息会取代列表，并提供返回操作。
• 浮动的撰写按钮会打开移动版撰写器。
• 设置会先打开全屏部分列表，然后显示选中的面板。
• 身份卡片、签名、From 地址选项和回复策略控制项会垂直排列，并使用适合移动设备的点按区域。
• 浅色和深色主题使用同一个响应式布局。

请使用可见的消息操作和选择复选框。网页邮箱目前不提供可配置的归档或已读滑动手势，也没有长按消息菜单。

安装为 PWA

安装 PWA 需要使用 HTTPS，并且浏览器必须支持安装。浏览器菜单中的文字可能会因操作系统和浏览器版本而异。

iPhone 或 iPad

1. 在 Safari 中打开网页邮箱 URL。
2. 点按共享。
3. 选择添加到主屏幕。
4. 检查名称，然后点按添加。

打开新图标后，网页邮箱会在没有常规 Safari 地址栏的独立窗口中运行。如果找不到添加到主屏幕，请确认页面是在 Safari 中打开，而不是应用内浏览器。

Android

1. 在 Chrome 或其他支持安装的浏览器中打开网页邮箱。
2. 打开浏览器菜单。
3. 选择安装应用或添加到主屏幕。
4. 确认安装。

如果没有安装选项，请更新浏览器，通过 HTTPS 重新加载网页邮箱，再次查看浏览器菜单。有些浏览器只会创建普通的主屏幕书签，而不是独立 PWA。

桌面设备

基于 Chromium 的桌面浏览器可能会在地址栏或应用菜单中显示安装操作。较新版本的 macOS 上，Safari 提供文件 → 添加到程序坞。如果浏览器不支持安装，请改用普通书签。

安装会改变什么

Service Worker 特意不会缓存已验证身份的页面、消息内容、附件、联系人或邮箱 API 响应。每项邮箱操作仍然需要网络连接。这可以防止私人邮箱数据存入通用 PWA 缓存。

离线页面会采用记住的浅色或深色主题，支持全部 13 种网页邮箱语言，包括阿拉伯语和希伯来语的 RTL 布局，并在浏览器报告网络恢复时重试。它只缓存这个公共页面及其品牌图片。

安装清单是一个小文件，用于向手机或浏览器说明应用名称、图标、颜色、起始页面和独立显示模式。你无需下载或配置它，网页邮箱会根据你打开的域名自动提供正确的清单。

通知

网页邮箱页面保持打开并进行轮询时，可以显示新邮件和日历提醒的浏览器通知。请在设置 → 个人资料 → 桌面通知中启用通知，并授予浏览器权限。

这并不是 Service Worker 后台推送。关闭浏览器或 PWA，或允许操作系统将其暂停，都会停止检查。不要依赖已安装的 PWA 接收后台新邮件提醒。如果后台同步和通知不可或缺，请通过 IMAP/SMTP 将邮箱连接到原生邮件客户端。

White Label 行为

在有效的 White Label Lite 主机上，登录页面、实时网页邮箱、安装、通知和离线页面都会使用服务商配置的品牌：

• 已安装应用的名称使用服务商的品牌名称。
• 安装图标和通知图标使用上传的 favicon。如果没有上传，网页邮箱会使用品牌主色生成中性邮件图标。
• 离线页面使用服务商名称、主色、浅色徽标和深色徽标。如果未上传深色徽标，则使用浅色徽标；如果两者都没有，则使用带品牌颜色的中性邮件图标。
• 离线布局仍会遵循选中的浅色或深色主题、移动设备安全区域、当前语言，并在适用时采用 RTL 方向。
• 独立应用会打开同一个品牌主机，其会话与 TrekMail 主机或其他服务商主机的会话相互独立。

请从你实际使用的网页邮箱 URL 安装，确保图标打开正确的来源和会话。同时安装 TrekMail URL 和服务商 URL 会生成两个独立图标和彼此独立的浏览器会话。

服务商更改品牌后，公共离线外壳会在下一次成功访问网页邮箱后刷新。手机操作系统可能仍会为已安装的应用保留旧主屏幕名称或图标；如果没有更新，请删除并重新安装快捷方式。

当前 PWA 限制

• 不支持离线阅读、搜索、撰写或排队发送。
• 不支持 Service Worker 后台推送通知。
• 不支持操作系统共享目标集成，无法将文件或文本直接发送到撰写器。
• 不缓存需要身份验证的应用外壳；为保护隐私并保持内容最新，导航仍优先使用网络。

问题排查

图标在普通浏览器标签页中打开： 删除快捷方式，然后使用浏览器的 PWA 安装操作或“添加到主屏幕”重新安装。普通书签可能不会以独立模式打开。

其他网站正常，但网页邮箱显示“连接已断开”： 点按重试。如果问题仍然存在，请暂时停用 VPN 或内容拦截器，在普通标签页中尝试网页邮箱 URL，并确认正确的品牌主机仍能解析。

应用更新后卡住： 将其完全关闭再重新打开。如有必要，请删除已安装的应用、清除该主机的站点数据、再次访问网页邮箱并重新安装。

没有出现通知： 保持网页邮箱打开，检查设置 → 个人资料 → 桌面通知，并检查浏览器和操作系统对该主机的权限。仅安装 PWA 不会启用通知。

无法离线阅读消息： 这是正常行为。网页邮箱只缓存公共的连接中断页面及其品牌图片。如果需要离线邮件，请使用具备自身离线同步功能的原生 IMAP 客户端。

原生日历、联系人和邮件应用

如需与操作系统日历和联系人同步，请使用 CalDAV 和 CardDAV：

• 连接 iPhone 和 iPad
• 使用 DAVx⁵ 连接 Android

如需原生邮件通知和离线邮箱同步，请参阅在移动邮件应用中设置 TrekMail。