README

Piik
来，看点好康的。私密屏幕共享，邀请最多 20 位朋友观看。

  官网 ·
  下载 ·
  AtomGit 镜像 ·
  在线版 ·
  文档中心


  
  
  

English · 简体中文

Piik 是一个免费开源的私密屏幕共享工具，适合游戏直播、一起看电影、展示绘画或分享照片。
选择画面，把邀请链接发给朋友，对方用浏览器即可观看。也支持自部署，搭建自己的 Piik 站点。


客厅小剧场 · 展开 / 收起动画





功能 · 开始使用 · 自行部署 · 参与贡献

 功能

- 观看无须安装。 朋友通过邀请链接，用电脑或手机浏览器加入。
- 用 Piik App 或已有 Piik 站点分享。 支持屏幕、窗口、浏览器标签页和摄像头；可选来源与音频能力取决于平台。
- 优先直接连接。 画面优先在设备之间传输（P2P），自建站点可启用媒体转发（SFU）自动兜底。
- 房间由你管理。 支持邀请链接、房间号和可选的房间密码，一位房主、最多 20 位观众。
- 边看边聊。 加入房间语音，发送文字和表情，也可开启弹幕。
- 让朋友接手操作。 通过 Piik App 分享窗口或屏幕并授权远控，也可允许多人共用键鼠或使用受支持的手柄一起玩，随时结束控制。查看设置方法。
- 灵活的观看方式。 支持深浅主题、播放控制、画中画和连接拓扑查看。
- 一个程序就能建站。 网页、房间管理和可选的媒体转发打包在同一服务端程序中。


  
    
    
  
  界面预览 · 示例房间与生成的游戏画面


 开始使用

观看分享： 打开朋友发来的邀请链接。画面没有自动播放时，点击播放即可。

分享画面： 推荐下载 Piik App。想免安装，也可以打开在线版直接创建房间。

| 从这里开始 | 需要做什么 |
| --- | --- |
| 使用在线版 | 用电脑浏览器分享画面；手机浏览器支持摄像头访问时，也可选择摄像头分享。 |
| 下载 Piik App | 电脑上解压程序包，手机或平板安装 App。打开 Piik，选择公网邀请，点击进入 Piik。 |



1. 点击开始分享，选择要分享的画面和声音。
2. 点击复制邀请链接，发给朋友。分享期间保持标签页打开。

打开 互动 → 语音 即可一起聊天，开播前后都能使用。
房主开启语音后，大家自行加入收听，想说话时再打开自己的麦克风。

Piik 默认跟随系统语言，中文系统显示简体中文，其他语言显示英文。
顶部的 中 / EN / ✦ 可切换中英文或体验纯视觉模式。
Piik App 可创建本地房间或临时公网邀请，也能在后台为已授权站点提供采集能力。分享期间需保持 App 运行。

图文上手教程 → · 问题排查 →

选择以 piik-app 开头的程序包；教程介绍安装、选择画面和邀请朋友的完整步骤。

浏览器采集需要 HTTPS 或 localhost。Piik App 的公网邀请和在线版使用 P2P，
参与者之间需要可用的 UDP 通路。校园网、画面连接失败或虚拟局域网的用法，见网络排查与连接方案。

 自行部署

部署 Piik Server，为朋友搭建自己的站点。



Piik Server 是内置网页界面的独立程序，支持 Windows x64 和 Linux x64／ARM64。
根据服务器架构下载 Linux x64 的 piik--runtime.tar.gz 或 ARM64 的
piik--linux-arm64-runtime.tar.gz，解压后运行：

sh
./piik-server


Windows x64 可下载 piik--windows-amd64-runtime.zip，解压后在 PowerShell
运行 ./piik-server.exe；配置方式相同。

打开 http://localhost:8787 即可在本机试用。对外提供服务时，
再配置域名、HTTPS 反向代理和 STUN 地址。房间数据保存在 SQLite 中。
也可以使用 Docker Compose 部署。

部署自己的站点 → · 配置参考 · 从源码运行

 参与贡献

欢迎反馈问题、参与翻译、改进文档或贡献代码。
从社区参与方式或
翻译教程开始，也可以从
项目目录说明了解代码结构。

 许可

Piik 自有代码采用 MIT 许可，依赖保留各自的许可与声明。

 项目动态

Top issues

Latest release

Piik, now in your pocket.

Piik App supports Android screen sharing, with touch controls for a friend's computer.

手机，也能开播。

Piik App 支持 Android 屏幕分享，也能用手机控制朋友的电脑。

 English

This maintenance update improves App authorization, capture-source switching and controls on smaller screens.

- Fix commentary controls remaining busy after switching from Browser capture to the App.
- Let App site approval recover from a stalled save, keeping access already granted.
- Preserve numeric-input focus when the mobile keyboard resizes the page, and provide increase/decrease buttons. Keep interaction windows a