Zotero 代理设置:系统代理、Connector 与 WebVPN 配置排错
简答:Zotero 代理设置分为桌面端系统代理和浏览器 Connector 代理:普通网络连接先检查系统代理,学校 WebVPN 抓取文献时再配置 Connector 的 Proxies;遇到旧规则或自动跳转,先停用或删除失效代理。
定义:Zotero 代理设置是指为 Zotero 桌面端或 Zotero Connector 指定系统代理、PAC、机构 WebVPN 及站点代理规则的过程。
先判断:你需要设置哪一种代理
本站为独立技术整理页,与 Zotero 项目无从属关系。本文按 2026年11月15日可访问的官方文档和公开教程整理;不同系统、浏览器和机构的菜单名称可能略有差异。
| 现象 | 优先检查对象 | 处理方向 |
|---|---|---|
Zotero 显示 Error connecting to server. Check your Internet connection. | 桌面端系统代理、PAC、证书和安全软件 | 检查系统代理是否为空、PAC 是否正确,再重启 Zotero |
| 浏览器打开数据库,Connector 抓不到条目 | Connector 的代理重定向规则 | 检查 Proxies、Configured Proxies 和 Hostnames |
| 学校 WebVPN 页面能开,但只保存网页快照 | 原始域名与 WebVPN 域名结构 | 根据代理后的 URL 配置 Proxied URL Schema |
| 浏览器和 Zotero 都无法连接 | 本地网络、系统代理、DNS 或安全软件 | 先确认普通网页访问,再排查代理和防火墙 |
官方说明指出,Zotero 默认使用系统中手动设置的代理或 PAC;浏览器能联网,并不能证明 Zotero 使用了同一套代理配置。可先阅读Zotero 官方连接错误说明确认分流范围。
Zotero 桌面端:检查系统代理与 PAC
- 先确认是否真的需要代理。如果普通网络不依赖代理,检查 Windows 或 macOS 的系统网络代理设置,关闭不再使用的手动代理和 PAC 地址。Zotero 官方建议:不使用代理时,应在系统代理设置中禁用代理。
- 确认代理类型。如果单位网络通过 PAC 自动分流,检查 PAC 地址能否在浏览器中打开,并确认其中包含 Zotero 访问所需的站点。若代理要求身份验证,登录提示未出现时,可能是 PAC 没有覆盖相关主机。
- 重启 Zotero 后复测。先测试同步、登录或普通网页请求,再测试 DOI 导入和 PDF 下载。不要同时修改系统代理、Connector 规则和安全软件,否则很难判断是哪一层生效。
- 需要独立代理配置时再用高级设置。官方文档提到,可以在 Zotero 偏好设置的 Advanced 区域进入 Config Editor,按 Firefox 的代理参数方式配置;默认使用系统代理的设置更适合作为起点,不建议没有明确需求时直接改高级参数。
如果修改系统代理后仍然报错,官方排查方向还包括防火墙、安全软件和证书问题。不要为了测试长期关闭证书校验;如需临时排查,应完成一次测试后立即恢复安全设置。
Zotero Connector:如何关闭或删除自动代理
Connector 的代理设置不等于 Zotero 桌面端的系统代理。它主要处理浏览器访问数据库时的代理重定向。打开浏览器中的 Zotero Connector 设置,进入 Proxies 区域,再根据故障选择下面的动作:
- 临时关闭自动跳转:取消
Enable proxy redirection。这样可以暂时停止代理重定向,已保存的代理规则仍会保留。 - 停止自动保存新代理:取消
Automatically detect new proxies。适合浏览器不断记录旧机构代理、访问地址反复变化的情况。 - 删除失效代理:在
Configured Proxies中选中不再使用的规则,点击减号删除。官方文档明确区分了“临时停用”和“已经无法访问该代理时删除”两种处理。 - 只对某些域名停用:如果机构网络内访问数据库不需要代理,可使用按域名禁用代理重定向的选项。域名字符串应以当前机构网络和页面地址为准,不要照抄其他学校的域名。
Safari 不支持 Zotero Connector 的代理规则功能;macOS 用户需要配置 WebVPN 规则时,应改用支持该功能的浏览器。相关开关和删除方式可对照Zotero 官方 Proxies 文档。
学校 WebVPN:配置 Proxied URL Schema 的方法
学校 VPN 客户端通常是系统层连接,而 WebVPN 是浏览器网页层代理。WebVPN 会改变数据库页面的 URL,Connector 可能因此无法识别原始网站的转换器。需要配置时,先准备同一页面的两条地址:一条是数据库原始 URL,另一条是登录 WebVPN 后实际打开的 URL。
- 拆分原始 URL。记录协议、Host 和 Path。例如原始地址可以拆分为
https://、d.wanfangdata.com.cn和periodical/...。 - 比较代理后的 URL。观察原始 Host 是否消失,还是被编码后放入代理域名;再看 Path 是否保持不变。
- 进入 Connector 的 Proxies → Configured Proxies。点击加号创建规则。Login URL Schema 填写 WebVPN 登录入口,通常是可选项;Hostnames 填写该规则适用的原始数据库域名。
- 填写替换符。
%h代表原始 URL 的 Host,Host 中的点会按规则转为短横线;%p代表原始 Path;%u代表完整原始 URL。只使用代理链接中确实对应的占位符。
常见的两类结构如下:
| 代理结构 | 判断方法 | 配置思路 |
|---|---|---|
| 代理后使用全新域名 | 代理地址中看不到原始 Host,Path 仍然保留 | 保留代理前缀,用 %p 替代原始路径 |
| 原始 Host 被编码到代理域名 | 例如域名中出现由原始 Host 转换出的短横线形式 | 通常使用 %h 和 %p,协议、端口及固定后缀按实际地址保留 |
WebVPN 的链接结构由学校或机构决定,不能把一个学校的规则直接套到另一个学校。可参考校外访问抓取配置说明中的结构分析方法,但最终应以你当前看到的原始 URL 和代理 URL 为准。
配置完成后怎么验证:不要只看网页能否打开
- 先在浏览器中打开原始数据库页面,确认机构登录状态有效。
- 再打开经过 WebVPN 的页面,检查地址是否符合预期,是否出现反复登录、无限加载或人机验证。
- 点击 Connector 保存条目,查看是否生成正确的标题、作者、期刊和 DOI,而不是只保存网页快照。
- 打开条目后再测试 PDF 下载。元数据能抓取但 PDF 失败,说明问题可能在全文权限、附件地址或下载代理,不一定是 Connector 规则错误。
- 如果规则触发了错误跳转,先关闭
Enable proxy redirection,重新打开原始页面;若恢复正常,再删除失效规则或重新分析 URL。
如果你遇到的是“浏览器能下载、Zotero 不能下载”,可以继续查看站内的Zotero PDF 下载失败排查;如果连登录页面也打不开,则应先看Zotero 登录与网络连接排查,不要先反复改 Connector 规则。
常见错误与改法
| 类别 | 错误或现象 | 可改进 |
|---|---|---|
| 错误 | 把系统代理地址直接填进 Connector 的 Proxied URL Schema | 先比较原始 URL 与 WebVPN URL,按 Host、Path 和固定前缀构造规则 |
| 错误 | 只关闭代理,不删除已经失效的 Configured Proxies | 临时测试用关闭开关,长期不用的机构代理应选中后删除 |
| 错误 | 看到浏览器能访问,就认定 Zotero 一定能访问 | 分别测试 Zotero 登录、元数据抓取和 PDF 下载 |
| 可改进 | 直接照抄其他学校的 WebVPN 示例 | 用自己机构的原始地址和代理后地址重新拆分并验证 |
| 可改进 | 同时修改系统代理、PAC、Connector 和防火墙 | 一次只调整一层,修改后重启并记录测试结果 |
进一步排查:代理不是所有连接问题的答案
如果关闭系统代理和 Connector 代理后仍无法访问,下一步应区分 DNS、网络延迟、丢包、证书和目标站点权限,而不是继续添加代理规则。对于 DOI 导入失败,可参考站内的Zotero DOI 导入失败分流;如果只是学校数据库页面打不开,则应先确认机构登录入口和服务状态。
若使用学校 WebVPN 仍无法抓取,另一个可行思路是分开处理:先在数据库页面获取文献元数据,再单独下载 PDF 并添加到条目。公开教程也指出,Connector 抓取元数据和下载附件可以是两个不同环节,因此不必把“抓不到 PDF”直接等同于“代理规则全部错误”。
常见问题
Zotero 代理设置应该在桌面端还是浏览器 Connector 中完成?
普通网络连接、同步和桌面端请求优先检查系统代理;学校 WebVPN 改写数据库网址时,才需要在浏览器 Zotero Connector 的 Proxies 中配置规则。两者不是同一个设置。
Zotero Connector 总是自动跳转到旧的学校代理,怎么办?
进入 Connector 的 Proxies 设置,先取消 Enable proxy redirection 做临时验证;如果旧代理已经失效,再在 Configured Proxies 中选中对应规则并删除。
%h、%p、%u 在 Zotero 代理规则中分别代表什么?
%h 表示原始 URL 的 Host,%p 表示原始 Path,%u 表示完整原始 URL。根据代理后地址实际保留的部分选择,不要把三个占位符全部填写。
浏览器能打开数据库,但 Zotero 显示 Error connecting to server,原因是什么?
可能是 Zotero 使用了不同的系统代理或 PAC,也可能受到防火墙、证书或安全软件影响。先检查系统代理,再单独测试 Zotero 登录、元数据抓取和 PDF 下载。
学校 WebVPN 的代理规则可以直接照抄网上示例吗?
不建议。不同机构的代理域名、端口、固定路径和 Host 编码方式可能不同,应使用当前机构的原始 URL 与代理后 URL 重新分析。
Safari 可以配置 Zotero Connector 的代理规则吗?
Zotero 官方 Proxies 文档说明该功能不适用于 Safari。需要配置 WebVPN 代理规则时,可改用支持该功能的浏览器。