Logbook of the World
Logbook of the World
目录
Wavelog 会把你的 QSO 上传到 ARRL 的 Logbook of the World（LoTW），并下载由此产生的确认。两个方向都由同一个后台任务处理。
该页面位于 User menu -> Third-Party Services -> Logbook of the World。
警告：Wavelog 不会下载你的日志
只会从 LoTW 获取确认。QSO 本身必须已经存在于你的 Wavelog 日志中——参见概览。
上传和下载使用不同的凭据：
- 上传使用你的 LoTW 证书（
.p12）签名。不涉及用户名或密码。 - 下载确认使用你的 LoTW 用户名和密码。
要完成完整同步，两者都需要配置好。
设置凭据
进入 User menu -> Edit profile -> Third Party Services 并填写你的 LoTW 用户名和密码。用字段旁的「测试登录」按钮可以立即验证它们。
注意
凭据是按用户账户存储的，而不是按台站位置存储。该账户下的每个呼号都使用同一个登录信息。如果你为不同呼号持有多个 LoTW 账户，请让 LoTW Helpdesk 把它们合并——一个 LoTW 账户可以管理多个呼号。
对于美国的 1x1 呼号，请使用为该 1x1 呼号申请证书的主账户的登录信息；1x1 呼号本身没有单独的 LoTW 登录。
上传证书
从 TQSL（2.7 或更高版本）导出证书：
- 打开 TQSL，进入「Callsign Certificates」标签页。
- 右键点击你要导出的呼号。
- 选择「Save Callsign Certificate File」，并且不要设置密码。
然后在 Wavelog 中通过 Logbook of the World -> Upload certificate 上传生成的 .p12 文件。
警告
受密码保护的
.p12无法导入。Wavelog 需要读取私钥才能无人值守地为上传签名。
上传之后，证书列表会显示：
| 列 | 含义 |
|---|---|
| 呼号 | 该证书签发给的呼号 |
| DXCC | 该证书所属的 DXCC 实体 |
| 创建日期 | 证书的签发时间 |
| 到期日期 | 证书本身的到期时间 |
| 状态 | 表示有效性、吊销状态以及最近一次上传结果的徽章 |
每次打开该页面时，Wavelog 都会检查 ARRL 的吊销列表，因此在 LoTW 上已被取代的证书会在这里被标记出来。
提示
如果上传
.p12失败并出现与 OpenSSL 相关的错误，很可能是没有启用 PHP 的openssl扩展。参见 LoTW P12 文件——无法上传。
证书有效期与 QSO 日期范围
LoTW 证书带有两个互相独立的日期范围：
- 证书有效期——在此期间证书可以用于为日志签名。
- QSO 起始日期与结束日期——QSO 本身必须落在该期间内。
举例：一张有效期从 2025-01-01 到 2030-12-31、QSO 范围为 2025-02-23 到 2026-08-28 的证书，无法为 2025 年 1 月或 2026 年 9 月做出的 QSO 签名，尽管该证书直到 2030 年都有效。
除非你是在记录一次有限期的操作（例如 DXpedition 或已删除的 DXCC 实体），否则在申请证书时请把 QSO 结束日期留空：
密钥的服务器端存储
私钥并不保存在网站根目录中。Wavelog 使用的目录可以在 application/config/lotw.php 中配置。请选择文档根目录之外的位置，并按 ARRL 指引的要求在文件系统上保护它。
上传 QSO
Wavelog 按台站位置构建签名后的 TQ8 文件，使用的是该位置自身的数据。如果你在一个新地点操作，只需创建该台站位置——上传任务会自动识别它，并检查是否存在匹配的证书。
当台站位置没有证书、DXCC 不匹配，或者证书已过期、已被取代、不在其 QSO 日期范围内时，该 QSO 会被跳过。
上传任务在 Cronmanager 中作为 lotw_lotw_upload 任务运行（Admin -> Cron Jobs），默认每小时一次。请不要把它安排得比每一到两小时更频繁。
区域注意事项
美国——台站位置中的县名必须与 LoTW 期望的拼写完全一致，例如州 OR、县 Deschutes。
加拿大——在台站位置中通过州/省下拉菜单选择你的省。
下载确认
有两种方式从 LoTW 获取匹配结果：
- 直接下载——Wavelog 使用你的 LoTW 用户名和密码自行获取匹配结果。这一步包含在同一个
lotw_lotw_upload任务中。 - ADIF 文件——从 LoTW 网站导出一份报告，并在 LoTW 导入页面上传它。按该页面上的说明生成正确的文件。
常见问题
为什么日志中的 LoTW 确认徽章显示的是过期数据？
某个 DX 台站的「最近一次上传到 LoTW」信息来自 LoTW 发布的 lotw-user-activity.csv 文件。ARRL 大约每周更新一次，时间在周日 1000z 左右，而 Wavelog 的 update_lotw_users 任务每周导入一次——因此这些数据最多可能滞后一周。
要了解某一呼号的当前状态，请使用 Logbook Find Call 或 QSO 详情中的「Last Upload」链接。两者都需要登录 LoTW 账户。
上传成功了，但 LoTW 说导入失败——为什么这些 QSO 被标记为已发送？
上传与 LoTW 端的处理是异步进行的。Wavelog 只能看到文件传输是否成功，并在此刻就把这些 QSO 标记为已发送。参见下文的已知问题。
上传正常，但下载不行
请检查你的 LoTW 用户名和密码。上传只需要证书，下载需要登录信息。如果你在 LoTW 修改了密码但没在 Wavelog 中修改，上传会继续正常工作，而下载会失败。
手动同步时典型的症状是：Downloaded LoTW report contains no matches。
有些 QSO 仍然无法上传
请检查该 QSO 的日期是否落在证书的 QSO 起始日期与结束日期之间——参见上文。超出该窗口的 QSO 无法签名，需要一张具有合适范围的新证书。
另一个常见原因是已被取代的证书：如果你在到期前续期，旧证书在 Wavelog 中仍然有效，但会被 LoTW 拒绝。请用新证书替换它。
为什么 Wavelog 不获取更早的确认？
Wavelog 只向 LoTW 请求比它已收到的最后一条确认更新的确认。原因和变通方法与 QRZ.com 相同——参见同步逻辑。
已知问题
对被拒绝的 QSO 没有任何反馈
如果 ARRL 不接受上传文件的一部分，这些 QSO 在 Wavelog 中仍会被标记为 LoTW 已发送，因为自动上传不会提供逐个 QSO 的反馈。这个问题无法从 Wavelog 一侧修复。
要检查，请登录 LoTW 网站并进入「Your Account -> Your Activity」。要重试某个已修正的 QSO，请手动清除它的 LoTW 已发送 字段。