WhenToMeetWhenToMeet

iCal 日历订阅

iCal 订阅允许您连接来自 Outlook、公共日历或任何其他提供 iCal 提要的日历服务的只读日历。这非常适合导入您无法控制的日程安排，例如工作日历、运动队日程表或公共假日日历。

什么是 iCal 订阅？

iCal（iCalendar 的缩写）是共享日历信息的标准格式。当您订阅 iCal 日历时：

  • 只读访问： 事件会自动从日历中提取，但您无法通过 WhenToMeet 修改它们
  • 自动更新： 日历会定期同步以获取新事件和更新
  • 通用兼容性： 适用于任何提供 iCal 提要 URL 的日历服务

如何查找您的 iCal 订阅 URL

Outlook 日历

  1. 打开 Outlook 日历（网页版）
  2. 右键单击要共享的日历
  3. 选择 设置 或 共享和权限
  4. 查找 获取可共享链接 或 ICS 链接
  5. 复制 URL（通常以 https:// 开头并以 .ics 结尾）

Google 日历（公共日历）

  1. 打开 Google 日历设置
  2. 选择要共享的日历
  3. 向下滚动到 集成日历
  4. 复制 iCal 格式的公共地址

注意： 对于具有完全读写访问权限的私有 Google 日历，请改用本机 Google 日历连接。

其他日历服务

大多数日历服务都提供 iCal 订阅选项：

  • 在您的日历设置中查找 订阅、导出 或 共享 选项
  • 查找 iCal、ICS 或 webcal URL
  • 复制完整的 URL

连接 iCal 订阅

  1. 在 WhenToMeet 中导航到 设置 页面
  2. 在 日历 部分下，单击 订阅 iCal 日历
  3. 将您的订阅 URL 粘贴到字段中
  4. URL 可以以下任一方式开头：
    • https:// - 标准安全 Web URL
    • webcal:// - 日历特定协议（自动转换为 https）
  5. 单击 订阅 进行连接

WhenToMeet 将验证日历 URL 并获取事件以确保其正常工作。

支持的 URL 格式

  • HTTPS URL： https://example.com/calendar.ics
  • Webcal URL： webcal://example.com/calendar.ics（自动转换）
  • ICS 文件： 指向托管在任何地方的 .ics 文件的 URL

iCal 订阅如何工作

  1. 初始连接： 当您连接时，WhenToMeet 会从日历中获取所有事件以验证其是否可访问
  2. 定期同步： 事件会定期自动同步以保持最新状态
  3. 冲突检测： 订阅的日历中的事件用于可用性检查，就像您的其他已连接日历一样
  4. 日期范围过滤： 仅获取您活动安排期内的事件以优化性能

故障排除

“日历需要身份验证”错误

此错误表示日历是私有的，需要凭据。要解决此问题：

  1. 在对话框中单击 “🔒 私人日历？添加身份验证”
  2. 输入您的用户名和密码（请参阅上面的 查找您的凭据）
  3. 确保您使用的是日历服务的正确凭据
  4. 在启用身份验证的情况下重试

如果身份验证仍然失败：

  • 验证您的用户名和密码是否正确
  • 检查您的服务是否需要特定于应用程序的密码而不是您的主密码
  • 确保日历 URL 正确且可访问

“身份验证失败”错误

如果您输入了凭据但身份验证失败：

  • 凭据错误： 仔细检查您的用户名和密码
  • 需要特定于应用程序的密码： 某些服务（如 Microsoft）需要特定于应用程序的密码
  • 用户名格式： 尝试不同的用户名格式（电子邮件与用户名）
  • 日历 URL： 验证 URL 是实际的日历提要 URL，而不是网页链接

“未找到任何事件”错误

如果订阅已连接但未显示任何事件：

  • 验证日历是否确实包含事件
  • 检查 URL 是否指向日历提要（.ics 文件），而不是网页
  • 某些日历可能仅提供将来的事件
  • 尝试直接在浏览器中访问 URL 以验证其是否下载了 .ics 文件

“连接超时”错误

如果连接超时：

  • 检查 URL 是否可访问（尝试在浏览器中打开它）
  • 日历服务器可能速度较慢或暂时不可用
  • 几分钟后重试
  • 检查您的互联网连接
  • 某些自托管服务器可能有限速

URL 格式无效

  • 确保 URL 完整且格式正确
  • 删除任何多余的空格或字符
  • 验证 URL 是否以 https:// 或 webcal:// 开头
  • 确保 URL 以 .ics 结尾或包含日历路径
  • 对于 NextCloud，请确保您使用的是订阅 URL，而不是 Web 界面 URL

私人日历身份验证

WhenToMeet 支持需要凭据的私人日历订阅的 HTTP 基本身份验证。这使您可以订阅来自 NextCloud、Radicale 或私人 Outlook 日历等服务的私人日历。

什么是基本身份验证？

基本身份验证是一种标准的 HTTP 身份验证方法，其中您的用户名和密码经过安全编码并随每个日历请求一起发送。您的凭据以加密方式存储在 WhenToMeet 的数据库中。

何时需要身份验证？

在以下情况下，您需要身份验证：

  • 私人 Outlook 日历： 未公开共享的日历
  • NextCloud 日历： 需要登录的个人日历订阅
  • 自托管日历服务器： Radicale、Baïkal、SOGo 和类似服务
  • 私人 iCal 提要： 任何返回 401 未授权错误的日历提要

大多数 公共日历（如公共 Google 日历提要或公开共享的 Outlook 日历）不需要身份验证。

如何使用身份验证

  1. 在 iCal 订阅对话框中，单击 “🔒 私人日历？添加身份验证”
  2. 输入您的 用户名（通常是您的电子邮件地址或帐户名）
  3. 输入您的 密码 或 特定于应用程序的密码
  4. 单击 订阅 进行连接

查找您的凭据

NextCloud

  • 用户名：您的 NextCloud 登录电子邮件/用户名
  • 密码：您的 NextCloud 密码或特定于应用程序的密码
  • URL：通常为 https://your-nextcloud.com/remote.php/dav/calendars/USERNAME/CALENDARNAME/?export

私人 Outlook 日历

  • 用户名：您的 Microsoft 帐户电子邮件
  • 密码：您的 Microsoft 帐户密码或特定于应用程序的密码
  • URL：在 Outlook 日历 → 设置 → 共享日历 → 发布日历 → 获取 ICS 链接中查找

Radicale / Baïkal

  • 用户名：您的日历服务器用户名
  • 密码：您的日历服务器密码
  • URL：由您的日历服务器提供（通常以 .ics 结尾或包含 /calendars/）

特定于应用程序的密码

许多服务建议出于安全原因使用 特定于应用程序的密码 而不是您的主帐户密码：

  • Microsoft： 在 account.microsoft.com → 安全 → 应用程序密码中生成
  • NextCloud： 设置 → 安全 → 创建新的应用程序密码

隐私与安全

  • 只读访问： iCal 订阅只能读取事件，绝不能修改您的日历
  • 加密凭据： 身份验证凭据以加密方式存储在数据库中
  • 基本身份验证支持： 用于私人日历的标准 HTTP 基本身份验证
  • SSRF 保护： WhenToMeet 会验证所有 URL 以防止访问专用网络或内部资源
  • 安全连接： 所有 webcal:// URL 都会自动升级为安全的 https:// 连接

与其他连接类型的区别

iCal 与 Google 日历

  • iCal： 只读，无需 OAuth，适用于任何公共日历
  • Google： 完全读写访问，OAuth 身份验证，可以创建事件

iCal 与 CalDAV

  • iCal： 用于只读访问的简单订阅，支持可选的基本身份验证
  • CalDAV： 具有读写访问权限的完全双向同步，需要 CalDAV 服务器支持

何时选择 iCal：

  • 只读访问就足够了
  • 日历提供 iCal/ICS 订阅 URL
  • 首选简单设置
  • 适用于 Outlook、公共日历和大多数日历服务

何时选择 CalDAV：

  • 您需要读写访问权限（创建/编辑事件）
  • 日历提供商支持 CalDAV 协议（iCloud、NextCloud、Fastmail）
  • 需要完全双向同步

何时使用 iCal

在以下情况下使用 iCal 订阅：

  • 您想导入 公共或共享 日历
  • 您只需要 只读 访问权限来检查冲突
  • 日历来自 Outlook 或其他没有本机集成的服务
  • 您想要一个没有 OAuth 身份验证的简单设置
  • 您有一个支持基本身份验证的 私人日历（请参阅 私人日历身份验证）

功能要求

iCal 订阅在某些订阅计划中可用。有关您的计划中包含哪些功能的详细信息，请查看 定价页面。

相关文档

Was this page helpful?