前言
孩子第一次提出想学钢琴时，家长通常既高兴又有些犹豫。真正的钢琴或电钢琴需要预算和摆放空间，后续还涉及课程与练习安排，而孩子的兴趣是否能够持续，短时间内很难判断。
在正式购买乐器之前，可以先给孩子准备一个简单的音乐体验入口。AutoPiano是一款运行在浏览器中的虚拟钢琴，使用电脑键盘、鼠标或平板触屏就能发声，不需要在每台设备上单独安装软件。
它不能代替实体钢琴的键盘力度、踏板和专业教学，但可以帮助孩子认识琴键、尝试简单旋律，也能让家长观察他是否愿意主动打开页面、重复练习，而不只是对“学钢琴”这件事一时好奇。
本文会以飞牛NAS为例，通过Docker运行AutoPiano，将容器服务映射到本地3030端口，再演示琴键操作、曲目页面和教学内容等基础功能。
局域网访问正常后，还会安装 cpolar，为AutoPiano创建公网访问地址并配置固定二级子域名。这样孩子更换网络或暂住在其他家人家中时，也能继续使用熟悉的练习页面。
1.什么是AutoPiano？
AutoPiano是一个开源的网页版虚拟钢琴应用，它让你无需安装任何软件，只需打开浏览器，就能在电脑、平板或手机上弹奏钢琴。
核心特点
| 纯网页运行 | 基于 HTML5 + Web Audio API，无需 Flash 或插件 |
| 键盘支持 | 可用电脑键盘按键模拟琴键（通常 A~; 对应中央 C 附近音符） |
| 触屏友好 | 在手机/平板上可直接点击屏幕琴键演奏 |
| 多音色切换 | 支持钢琴、电钢、风琴等多种乐器音色（取决于具体版本） |
| 完全免费 & 开源 | 代码公开，无广告、无付费墙，可私有部署 |
| 纯网页运行 | 基于 HTML5 + Web Audio API，无需 Flash 或插件 |
| 键盘支持 | 可用电脑键盘按键模拟琴键（通常 A~; 对应中央 C 附近音符） |
| 触屏友好 | 在手机/平板上可直接点击屏幕琴键演奏 |
| 多音色切换 | 支持钢琴、电钢、风琴等多种乐器音色（取决于具体版本） |
| 完全免费 & 开源 | 代码公开，无广告、无付费墙，可私有部署 |
技术背景
-
前端技术：通常使用JavaScript（如Vue.js、React或原生Web Audio）
-
音频引擎：基于浏览器的Web Audio API，能生成高质量合成音
-
部署方式：打包成静态网站，可通过Nginx、Node.js或Docker轻松部署
-
典型项目名：
GitHub上常见项目如davidjbradshaw/piano
中文社区流行的 “自由钢琴” 多指基于类似原理的增强版（如baiyuetribe/onekey:piano镜像所用）
为什么适合家庭 NAS（如飞牛 fnOS / 群晖）？
- 轻量级：资源占用极低，老旧设备也能跑
- 私有化部署：数据不外传，孩子使用更安全
- 随时访问：局域网内任何设备打开浏览器即可练习
- 零成本试水：在购买实体钢琴前，先验证孩子是否真有兴趣
2.安装前提条件
2.1ssh远程连接到飞牛
- 开启【SSH 服务】
- 使用终端（Windows PowerShell / Mac Terminal）登录：
在设置—>SSH中开启SSH服务：
2.2验证docker是否开启
使用命令：
docker -v
systemctl status -v
也可以直接在飞牛主页查看（其他机器也是这样的哦~）
3.部署AutoPiano
3.1 安装AutoPiano
本文使用docker一键部署：
docker run -d \\
-p 3030:5000 \\
-e HOST=0.0.0.0 \\
-e PORT=5000 \\
–name=piano \\
baiyuetribe/onekey:piano
部署完成后，在浏览器中输入 http://飞牛IP:3030 就能看到AutoPiano的界面：
3.2 使用AutoPiano
部署完成后，我们就可以看见autopiano的页面。特别容易上手，好操作，下面选项可以自由选择：
点击这里可以跳转音乐平台链接：
下面有音乐曲目：
我们点击进去，有教学，就不用费力去网上寻找了：
还有演示视频：
你是否遇到过这样的场景？
在家里的飞牛NAS（fnOS）或群晖上成功部署了AutoPiano，孩子可以在局域网内愉快地练习。
但一出门——爷爷奶奶想看看孙子弹琴？朋友想远程试玩？自己在公司突然来了灵感想即兴演奏？
统统不行！因为服务只在本地网络可见。
这时候，你就需要一个强大的内网穿透工具 —— cpolar。跟我继续配置吧！
4.安装cpolar实现随时随地开发
4.1 什么是cpolar？
cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。
4.2 部署cpolar
cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。
❤️以下是安装cpolar步骤：
使用一键脚本安装命令：
sudo curl https://get.cpolar.sh | sh
安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）
sudo systemctl status cpolar
Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：
打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。
5.配置公网地址
登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：
- 隧道名称：可自定义，本例使用了:piano，注意不要与已有的隧道名称重复
- 协议：http
- 本地地址：3030
- 域名类型：随机域名
- 地区：选择China Top
创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用地址访问。
访问成功。
6.保留固定公网地址
使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。
点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是piano，大家可以自定义。填写备注信息，点击保留。
登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。
修改隧道信息，将保留成功的二级子域名配置到隧道中
- 域名类型：选择二级子域名
- Sub Domain：填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。
最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。
总结
完成部署以后，飞牛NAS负责持续运行AutoPiano，家里的电脑、平板和手机都可以通过浏览器打开同一个页面。它不占用额外摆放空间，也适合用来进行短期兴趣体验。
网页版琴键的优势是方便，局限也很明显。电脑键盘没有轻重力度，手机屏幕能够同时操作的琴键有限，浏览器音频还可能受到设备性能和网络延迟影响，因此不能把它当作实体钢琴的完整替代品。
家长可以把它作为观察工具，看孩子是否愿意持续练习节奏、旋律和手指对应关系。兴趣稳定以后，再考虑电钢琴、传统钢琴或正式课程，会比单纯根据一次表达立即购买更稳妥。
通过 cpolar 映射3030端口后，可以从外部网络访问练习页面。随机地址适合临时测试，固定二级子域名更方便长期使用，但没有远程需求时，也可以只保留局域网访问。
如果页面中包含外部曲目、视频或音乐平台链接，应注意内容来源和版权范围，也要避免孩子在无人陪同的情况下跳转到不熟悉的网站。对低龄儿童来说，控制单次使用时间和音量同样重要。
AutoPiano负责提供低门槛的音乐体验，飞牛NAS负责运行服务，cpolar负责补上远程访问入口。整套方案最适合用来验证兴趣和增加家庭互动，而真正的钢琴学习仍需要合适的乐器、正确姿势和专业指导。
