[{"_1":2,"_174":-5,"_175":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_149":150},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_138":-5,"_139":11,"_140":21,"_141":11,"_142":-5,"_143":11,"_144":-5,"_145":146,"_147":91,"_148":-7},"canonicalUrl","https://hub.docker.com/r/darkyzhou/junjun-transfer/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","darkyzhou","reponame","junjun-transfer","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2021-05-20T12:59:36.212328Z","description","","is_private","last_updated","2022-04-30T18:45:21.005291Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",304,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"junjun-transfer$ \n

俊俊快传

\n $\"GitHub\"$ \n $\"GitHub$ \n $\"GitHub$ \n $\"GitHub$ \n $\"GitHub$ \n

\n\n### 简介\n\n[https://junjun.darkyzhou.net](https://junjun.darkyzhou.net)\n\n基于 WebRTC 技术的浏览器点对点文件传输工具，可以让用户**一对一**地将文件传输给另一个用户。和目前常见的使用 QQ、微信等软件进行文件传输相比，俊俊快传直接将文件从发送者传输到接收者，不需要经过中间服务器的存储。也就是说，俊俊快传不需要由发送者先将文件上传到一个服务器上，上传之后再由接收者下载。\n\n这使得人们可以使用俊俊快传快速地将文件分享给朋友。俊俊快传支持传输的文件种类非常广泛，从图片到视频、从 PDF 文件到压缩包，它都能够支持传输。不过目前，由于 STUN 技术的限制，在发送者和接收者都处于类似于对称型 NAT 这样的网络环境下时，俊俊快传几乎不能工作。\n\n本项目分为前端后端两个部分，其中前端 SPA 基于 Vite、React、TailwindCSS、socket.io，后端基于 Express、socket.io。\n\n### 使用\n\n目前，俊俊快传有一个位于香港阿里云服务器的实例：[https://junjun.darkyzhou.net](https://junjun.darkyzhou.net)。\n\n> 注意，请使用尽可能新版的浏览器来使用 WebRTC。这不仅是因为新版浏览器对于 WebRTC 的实现更成熟、稳定，也因为俊俊快传的前端项目使用了许多较新的 API。\n\n当你打开网页之后，点击左侧卡片选中要传输的文件，然后就能够将二维码或链接分享给接收文件的朋友，在朋友打开链接之后，如果 WebRTC 链接成功建立，那么你就可以点击 “发送” 按钮将文件传输给对方了。\n\n> 请不要在挂着代理的状态下打开俊俊快传，代理会影响到 WebRTC 识别并建立连接。\n\n![](https://github.com/darkyzhou/junjun-transfer/raw/master/preview.jpg)\n\n### 技术原理\n\n简单来说，俊俊快传使用 WebSocket 搭建了一个信令服务器，让传输双方的浏览器可以交换 ICE Candidate，进而能够让双方的浏览器尝试连接上对方。连接成功，开始传输文件时，俊俊快传使用 DataChannel 将文件数据从发送方的浏览器发送到接收方。\n\n在传输过曾中，接收方会通过与信令服务器的 WebSocket 连接，发送文件接收的情况（接收字节、速度等），再由信令服务器转发给发送方，这样发送方就能准确知道接收方接收文件的进度。\n\n对于 WebRTC 相关的代码，请见 [frontend-app/src/webrtc](https://github.com/darkyzhou/junjun-transfer/tree/master/frontend-app/src/webrtc)。\n\n### 安装\n\n你也可以自己搭建一个俊俊快传服务器，请参考以下的指导：\n\n#### 搭建 [ICE](https://en.wikipedia.org/wiki/Interactive_Connectivity_Establishment) 服务器\n\nICE 服务器不属于俊俊快传本体的范畴，你需要在搭建俊俊快传服务之前准备好 ICE 服务器。\n\n俊俊快传需要连接 [ICE](https://en.wikipedia.org/wiki/Interactive_Connectivity_Establishment) 服务器才能让文件传输的双方能够成功连接到彼此。[ICE](https://en.wikipedia.org/wiki/Interactive_Connectivity_Establishment) 服务器分为 [STUN](https://en.wikipedia.org/wiki/Session_Traversal_Utilities_for_NAT) 服务器和 [TURN](https://en.wikipedia.org/wiki/Traversal_Using_Relays_around_NAT) 服务器，其中后者实质上是一种流量中转服务器，可以解决上面提到的双方位于对称型 NAT 网络下俊俊快传不能工作的问题，因为所有流量都将由这个中转服务器转发。\n\n你可以直接使用 `junjun.darkyzhou.net:3478` 这个 STUN 服务器，或者如果你需要自建的话，目前 GitHub 上可以搜索到许多 [ICE](https://en.wikipedia.org/wiki/Interactive_Connectivity_Establishment) 服务器的实现，有些也实现了 [TURN](https://en.wikipedia.org/wiki/Traversal_Using_Relays_around_NAT) 协议，可以参考它们在 README.md 里写的安装方法进行搭建。上述的 [https://junjun.darkyzhou.net](https://junjun.darkyzhou.net) 使用的 STUN 服务器基于 [coturn/coturn](https://github.com/coturn/coturn)。\n\n#### Docker 安装\n\n建立一个 `ice-servers.json` 文件，内容如下。\n\n```json\n{\n \"version\": \"1\",\n \"servers\": [\n {\n \"type\": \"stun\",\n \"id\": \"local-test\",\n \"url\": \"stun:192.168.20.88:3478\",\n \"displayName\": \"Local Test A\",\n \"description\": \"I am for local development only!\"\n },\n {\n \"type\": \"turn\",\n \"id\": \"local-test\",\n \"url\": \"turn:192.168.20.88:3478\",\n \"username\": \"user\",\n \"credential\": \"password\",\n \"displayName\": \"Local Test B\",\n \"description\": \"I am for local development only!\"\n }\n ]\n}\n```\n\n其中：\n\n| 参数 | 解释 | 示例 |\n| ----------- | -------------------------------------------------------------------------------- | ---------------------------------- |\n| type | ICE 服务器的类型，只能为 `stun` 或 `turn` | `stun` |\n| id | ICE 服务器的 ID，建议使用全小写英文以及`-` | `local-test` |\n| url | ICE 服务器的 URL。如果是 `stun` 服务器，必须以 `stun:` 开头；`turn` 服务器类似。 | `stun:192.168.20.88:3478` |\n| username | ICE 服务器的用户名。STUN 服务器选填，TURN 服务器必填。 | `user` |\n| credential | ICE 服务器的密码。STUN 服务器选填，TURN 服务器必填。 | `password` |\n| displayName | ICE 服务器的名称，它会显示在网页下方的“ICE 服务器”对应的列表中 | `Local Test A` |\n| description | ICE 服务器的介绍，它会显示在网页下方的“ICE 服务器”对应的列表中 | `I am for local development only!` |\n\n然后，运行下面的命令即可：\n\n```plain\ndocker run -p 80:80 -v ./ice-servers.json:/backend-app/config/ice-servers.json --restart always darkyzhou/junjun-transfer\n```\n\n俊俊快传的 Docker 镜像只暴露了 80 端口作为 HTTP 入口，如果你需要 HTTPS，那么你需要手动设置一个反向代理，以及对应的证书。\n\n#### Kubernetes 安装\n\n俊俊快传也自带了一份用于部署到 Kubernetes 集群的 YAML 文件，请参考 [deploy-k8s.yaml](https://github.com/darkyzhou/junjun-transfer/blob/master/deploy-k8s.yaml)。\n\n### 缺陷\n\n俊俊快传只是本人为了研究 WebRTC 的练习项目，本人不对它的可靠性做出任何保证以及不担负任何责任。目前，俊俊快传还存在许多缺陷，它们其中有一些是因为我目前精力有限难以修复，有些则是 WebRTC 本身的不足等，难以解决：\n\n#### 传输速度\n\n俊俊快传使用了 WebRTC DataChannel 来实现文件的传输。但是，俊俊快传只能使用其中的可靠传输模式，并且开启了有序传输模式。由此，SCTP 协议会保证传输的可靠性以及有序性，但是这也给传输速度带来了较大的影响。\n\n经过内网、公网的多次传输测试发现，俊俊快传的速度只能达到链路带宽上限的大约 30% ~ 50%。\n\n#### 不能随意刷新页面\n\n双方如果有一方与信令服务器的 WebSocket 连接断开，那么本次文件传输则会被迫结束，要重新传输的话必须由发送方刷新页面，重新给接收方发送一个链接。\n\n这是不方便的，因为由于各种网络因素，尤其是当有一方在使用并不稳定的移动网络时，WebSocket 连接较容易断开。\n\n#### 兼容性问题\n\n各大浏览器在 WebRTC 的兼容性上有着各种奇怪的问题，目前最稳定、受到最多测试的是双方都使用 Chrome 浏览器的情景。而对于一方为 Chrome 浏览器，另一方为其他浏览器（例如 FireFox）的情况，或者其他组合，那么他们之间在建立 WebRTC 连接上有可能出现问题，导致俊俊快传不能正常工作。\n\n### 其他\n\n本项目的 Logo 来自 Twitter，遵循 [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/) 协议。\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",520184937,"orgData","recentTags",[91,128],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_50":117,"_118":94,"_119":33,"_120":56,"_57":121,"_122":123,"_124":108,"_125":117,"_126":66,"_127":21},"content_type","creator",10064254,"full_size",58721331,"id",150572006,"images",[101],{"_102":103,"_104":105,"_106":48,"_107":108,"_109":110,"_111":112,"_113":48,"_114":-5,"_115":96,"_63":66,"_116":-5},"architecture","amd64","digest","sha256:448718c67d5cde0ade23a6e04d8d837d8477d8b3290eba4c1ace9c6b43c01f89","features","last_pulled","2026-09-27T00:41:53.559983189Z","last_pushed","2022-04-30T18:45:21Z","os","linux","os_features","os_version","size","variant","2022-04-30T18:45:20.885577Z","last_updater","last_updater_username","media_type","latest","repository",13764814,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_92":44,"_93":94,"_95":129,"_97":130,"_99":131,"_50":136,"_118":94,"_119":33,"_120":56,"_57":137,"_122":123,"_124":134,"_125":136,"_126":66,"_127":21},132936371,151319874,[132],{"_102":103,"_104":133,"_106":48,"_107":134,"_109":135,"_111":112,"_113":48,"_114":-5,"_115":129,"_63":66,"_116":-5},"sha256:bd6458832cf81e8c6583cd4e8f09e90b13a975dcc5a9ded577a5b9bf472ea336","2026-09-24T08:59:33.923323343Z","2021-05-26T12:12:54Z","2021-05-26T12:12:53.81796Z","0.3.0","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":151,"_158":159,"_145":172,"_173":11},{"_40":152,"_42":153,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":154,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":155,"_79":11,"_80":157,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":156},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_160":161,"_162":-5,"_163":-5,"_164":165},"count",2,"next","previous","results",[166,169],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":167,"_50":117,"_118":94,"_119":33,"_120":56,"_57":121,"_122":123,"_124":108,"_125":117,"_126":66,"_127":21},[168],{"_102":103,"_104":105,"_106":48,"_107":108,"_109":110,"_111":112,"_113":48,"_114":-5,"_115":96,"_63":66,"_116":-5},{"_92":44,"_93":94,"_95":129,"_97":130,"_99":170,"_50":136,"_118":94,"_119":33,"_120":56,"_57":137,"_122":123,"_124":134,"_125":136,"_126":66,"_127":21},[171],{"_102":103,"_104":133,"_106":48,"_107":134,"_109":135,"_111":112,"_113":48,"_114":-5,"_115":129,"_63":66,"_116":-5},[],"canDeleteTags","actionData","errors"]

darkyzhou/junjun-transfer

Tags for darkyzhou/junjun-transfer