ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

croc 如何为中继与 croc-web 配置 Umami 传输统计?

croc 如何为中继与 croc-web 配置 Umami 传输统计? croc 如何为中继与 croc-web 配置 Umami 传输统计【免费下载链接】crocEasily and securely send things from one computer to another :crocodile: :package:项目地址: https://gitcode.com/GitHub_Trending/cr/croc如果你自托管了 croc 的中继croc relay或croc-web统一服务器并希望记录真实的传输行为就可以通过 Umami 做匿名统计。Umami 会记录普通 pageview以及 croc 发出的自定义事件中继侧的relay-session、浏览器侧的send-direct/send-with-storage/receive以及 croc-web 服务端为 curl 安装器下发的installer-curl。这套统计是可选的只要对应的环境变量没设全追踪会被整体禁用传输行为与未配置时完全一致。统计是否生效只取决于启动时读到的环境变量配置方式因服务而异croc relay读取 4 个变量croc-web读取 2 个变量且对UMAMI_URL的协议要求也不同。前提是你已有一个可访问的 Umami 实例一个 HTTP/HTTPS 服务地址以及一个网站 ID。两个服务读取的环境变量不同这是配置前最需要分清的一点两个服务虽然都叫配置 Umami但读到的变量和校验规则并不相同变量croc relaycroc-web说明UMAMI_URL必需HTTP 或 HTTPS必需仅 HTTPS你的 Umami 实例地址UMAMI_WEBSITE_ID必需必需Umami 中的网站 IDUUIDSITE_URL必需不使用上报用的站点主机名或地址UMAMI_SRC可选不使用拼到事件名后relay-session-src三者/两者必须同时设置缺失任何一个都不会启用统计详见下方各自的启用条件。croc relay的UMAMI_URL可以是 HTTP 或 HTTPS由 NewUmamiReporter 校验而croc-web要求UMAMI_URL必须是 HTTPS由 parseWebUmamiConfig 校验。如果你给 croc-web 传了 HTTP 地址会得到web analytics disabled的告警而不是统计。croc-web 的上报站点是命令行传入的公网地址参数如getcroc.com不需要SITE_URLcroc relay 则必须显式提供SITE_URL。为 croc relay 配置 Umamicroc relay的 relay() 逻辑 会读取 4 个环境变量只有当UMAMI_URL、UMAMI_WEBSITE_ID、SITE_URL三者都非空时才创建上报器export UMAMI_URLhttps://umami.schollz.com # 文档示例值换成你的 Umami 实例地址 export UMAMI_WEBSITE_IDwebsite-uuid # 文档示例值换成你的 Umami 网站 ID export SITE_URLrelay.example.com # 站点主机名或 http(s) 绝对地址需替换 export UMAMI_SRCweb # 可选省略则事件名就是 relay-session croc relay --host RELAY_BIND_HOST --port 9009 --transfers 4变量含义与校验规则均来自源码替换值需满足这些条件UMAMI_URL非空且必须是绝对 HTTP 或 HTTPS 地址否则会报Umami URL cannot be empty/Umami URL must be an absolute HTTP or HTTPS URL。UMAMI_WEBSITE_ID非空否则会报Umami website ID cannot be empty。SITE_URL非空可以是主机名也可以是绝对 HTTP/HTTPS 地址不能包含路径、查询串或 fragment否则报site URL must be a hostname or absolute HTTP or HTTPS URL或site URL cannot contain a path, query, or fragment。RELAY_BIND_HOST是你自己的中继绑定主机文中占位符请替换为实际地址--port 9009 --transfers 4表示基础端口 9009、共 4 个端口。中继要求至少两个端口。UMAMI_SRC可选。设置后事件名变为relay-session-src例如relay-session-web便于区分不同来源的中继。配置成功时每当一个中继房间配对完成就会发出事件relay-session或带后缀的变体事件路径固定为/relay最终 POST 到UMAMI_URL/api/send。为 croc-web 配置 Umamicroc-web 的启用条件是两个变量都非空且UMAMI_URL必须是 HTTPS。croc-web服务入口在 serve() 中把UMAMI_URL、UMAMI_WEBSITE_ID读入配置webrelay.Run 完成校验与初始化。web/README.md给出的生产示例可直接参考UMAMI_URLhttps://umami.schollz.com \ UMAMI_WEBSITE_IDwebsite-uuid \ croc-web --bind 127.0.0.1:9014 getcroc.com上面的https://umami.schollz.com与website-uuid是文档中的示例值请替换为你自己的 Umami 实例地址与网站 ID。最后一个位置参数getcroc.com是对外公网地址它会作为 croc-web 上报事件时使用的站点。croc-web 启用后做两件事向每个 HTML 页面的head注入延迟加载脚本见 injectUmamiScript。注入的固定格式为script defer srcUMAMI_URL/script.js contenteditable="false">【免费下载链接】crocEasily and securely send things from one computer to another :crocodile: :package:项目地址: https://gitcode.com/GitHub_Trending/cr/croc创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表