尧图网站建设 
简介面向需要远程控制 Android 设备的开发者与测试人员这份 Android VNC Server 资源提供了可在 Android 端运行的 VNC 服务端源码让 PC 通过 VNC Viewer 即可实现连接与设备操控适用于真机调试、自动化测试、演示教学等场景。包内关键编译问题已修复免去自行排查错误的繁琐过程可直接构建并部署使用。压缩包共 174 个文件核心实现以 C 源码84 个 .c与头文件25 个 .h为主同时配有 autoconf/automake 构建脚本、jar 辅助包、版本说明与变更记录等整体体积仅 1.08MB结构紧凑、层次清晰。已有 2554 人学习下载适合需要搭建 Android 远程控制环境、研究 VNC 协议实现或二次开发服务端功能的技术人员。资源包保留了完整的构建配置体系对理解 Android 原生程序编译流程和交叉编译方法也有参考价值同时可作为团队备份基线或方案对比的素材。 前阵子在做多设备自动化测试需要同时盯着好几台Android设备的状态一会儿跑过去看一眼一会儿又跑回去点一下效率低得让人抓狂。后来我在每台待测设备上装了一个VNC服务端人坐在工位上就能用电脑同时看所有设备的画面需要操作的时候鼠标一点就能接管彻底把这个问题解决了。这套方案就是今天要聊的Android VNC Server——在Android设备上跑一个标准的VNC服务端让任意平台的VNC客户端都能连接进来做远程查看和操控。它能解决的场景很明确开发调试、自动化测试监控、给同事演示App效果、临时帮人处理设备问题。不用装厂商私有客户端也不依赖账号体系一套标准VNC协议走天下Windows、macOS、Linux的VNC Viewer都能直接连。适合移动开发、测试、运维以及所有喜欢折腾工具的朋友。下面把从选型到搭建再到排坑的完整过程记录下来按我的实际体验来写。1. 需求场景与方案选型1.1 为什么需要给Android跑VNC服务桌面环境的远程控制几乎是标配Windows有自带的RDPLinux有VNCmacOS有屏幕共享。Android虽然是移动系统但在开发、测试和运维场景里远程查看和操作设备的需求其实非常频繁甚至比桌面端更迫切。我遇到最多的是三类情况。第一类是自动化测试跑Monkey或者Appium的时候你得随时知道设备当前卡在哪个页面、是不是弹了崩溃对话框、CPU是不是被打满。以前每次都要跑到测试架旁边看设备多了根本看不过来。接入VNC之后电脑上开几个窗口切着看就行效率完全不在一个量级。第二类是开发调试在平板上调试某个适配问题但人坐在工位上手边只有电脑操作设备很别扭。VNC连上以后用鼠标键盘直接操控改配置、点按钮、滑动页面都方便很多。第三类是临时协助朋友或者同事手机遇到问题远程指导半天说不清楚让对方装一个VNC服务端你本地用Viewer连过去直接看着屏幕操作解决问题比电话里盲猜高效得多。还有一个很重要的点VNC是开放协议服务端只需要实现RFB协议客户端那一端几乎不用挑Windows、macOS、Linux都有成熟稳定的Viewer甚至手机上也能装Viewer去连别的设备。这意味着方案的通用性极强不依赖任何一家厂商的私有生态也没有账号体系绑定的问题。1.2 主流方案对比与我的选择在确定自建VNC之前我认真比较过几个候选方案这里直接讲结论。第一个是商业远程控制工具比如AirDroid、向日葵这类。体验确实好App装好、注册账号、扫码几步就能连上基本零门槛。但问题也很明显数据要绕一圈第三方服务器有免费版限制而且它解决的是人连人的问题不是程序连设备的问题。如果你想通过标准VNC协议把自己的工具链接进来商业软件做不到。第二个是scrcpy。这个工具我平时用得非常多通过ADB实现屏幕镜像和控制延迟极低、画质极好简直是Android开发者的神器。但它不是服务端形态依赖电脑端跑scrcpy进程手机端只是通过ADB暴露了一个调试服务。如果场景是在一台电脑上通过VNC协议接入另一台电脑正在调试的设备scrcpy就力不从心了。第三个是早期的android-vnc-server。这个老方案要求设备root直接读取framebuffer设备节点抓取屏幕内容然后把帧数据发给VNC客户端。思路很硬核但Android 5.0之后系统对底层显示链路的权限管控越来越严这个项目基本已经废了新设备上跑不起来只适用于老版本系统。最后实际落地的方案是droidVNC-NG。它的核心思路是调用Android官方提供的MediaProjection屏幕采集API不需要root从Android 5.0到Android 14都能稳定运行而且是标准的VNC服务端实现。实测局域网内连接流畅度可以接受画面延迟大概在两三百毫秒级别日常看状态、做操作完全够用。方案是否需要root服务端形态主要限制商业工具AirDroid/向日葵否客户端账号依赖第三方服务器、有免费限制scrcpy否需ADB电脑端进程不是标准VNC监听依赖ADB通道android-vnc-server老方案是设备端服务仅适合Android 5.0之前的系统droidVNC-NG否设备端服务后台可能被系统限制需要调优选droidVNC-NG的原因可以总结成三点不需要root、标准VNC协议、开源可审计。对于需要长期稳定使用的工具这三点缺一不可。2. 搭建前必须搞懂的底层逻辑2.1 droidVNC-NG的工作原理很多人以为VNC就是截屏传图其实底层用的RFB协议Remote FrameBuffer比这稍微复杂一点但理解核心流程就够了不用啃协议文档。Android端的VNC服务端启动之后主要做两件事一是把屏幕内容编码成RFB协议要求的帧格式通过TCP端口发给连接的客户端二是接收客户端传来的鼠标键盘事件转换成Android的InputEvent注入到系统里。简单说就是屏幕传出去操作收进来方向和RDP基本一致。这里最关键的一环是屏幕采集。droidVNC-NG没有用任何系统私有接口而是调用Android 5.0开始提供的MediaProjection API。这个API要求应用在运行过程中弹出一个系统级授权对话框用户点允许之后应用才能拿到一个虚拟显示VirtualDisplay的句柄把屏幕渲染内容输出到Surface上。整个链路大致是屏幕内容 - 虚拟显示 - Surface - 像素缓冲 - RFB编码 - TCP网络端口。之所以要强调授权对话框是因为这个授权不是装完App就永久生效的。设备重启、或者应用进程被系统杀掉之后下次启动服务经常需要重新点一次授权。这一点在实操中非常容易踩坑很多人连上黑屏就卡在这里后面我会专门展开。2.2 网络与权限的几个关键点VNC服务端跑起来之后客户端怎么连进来通常有三种方式按实际使用频率来说我建议你从第二种开始尝试。第一种是局域网直连。设备连上Wi-Fi查看IP地址客户端直接用IP:端口访问。这种方式最简单适合设备在同一个办公网或者家庭网环境。但需要注意有些办公网开了AP隔离手机和电脑虽然连的是同一个Wi-Fi互相之间却完全访问不到这时候就得换第二种方式。第二种是ADB端口转发。设备通过USB线连到电脑上先用adb forward命令把电脑的某个本地端口映射到设备上的5900端口然后客户端只需要连接电脑的本地端口即可。这个方式的优点是数据全程走USB线完全不暴露在局域网里安全性最高而且即使设备没网也能用。我在办公室环境里基本都走这条路。第三种是无线ADB转发。Android 11之后的设备支持无线调试可以先通过ADB配对连接设备然后再做端口转发。这种方式的优点是既不用插线数据依然通过ADB隧道传输不会直接把VNC端口暴露在局域网里兼顾了便利性和安全性。权限方面除了MediaProjection授权国内厂商的ROM普遍有后台进程管理机制VNC服务端如果长期驻留后台很容易被系统当作不常用应用杀掉。解决办法就是把应用加入电池优化白名单、允许自启动和后台活动。这个坑我踩过不止一次服务跑着跑着突然断连排查半天发现是进程被系统回收了。3. 实操从安装到连通的一次完整记录3.1 安装、授权与启动服务第一步是下载droidVNC-NG的APK。项目在GitHub上开源Release页面直接下载最新版安装包装到Android设备上。不用区分手机还是平板只要是Android 5.0以上的设备都可以。装好之后打开应用界面非常简洁。首次启动会弹出系统授权对话框提示是否允许应用录制屏幕之类的权限这里必须点允许否则后面连上也是黑屏。这一步其实是MediaProjection API的系统弹窗属于正常流程不是应用自己画的伪造界面。进入主界面后有几个关键配置项需要确认一下端口默认是5900一般不用改只有同一台设备上跑多实例才需要改。密码设置一个连接密码建议至少8位别用生日这种弱密码。连接类型默认选TCP即可不开TLS的话就不用配置证书省去一堆麻烦。配置好之后点启动按钮状态栏出现一个常驻通知代表服务已经在后台监听了。这里有一个细节启动服务时如果系统又弹了一次授权框记得再点一次允许别直接关掉。启动成功之后我习惯先用ADB确认一下服务真的起来了命令很简单adb shell netstat -tlnp | grep 5900如果看到有进程在监听5900端口说明服务端工作正常可以进入下一步了。3.2 局域网直连与VNC Viewer连接服务端启动后我拿了一台Windows电脑做客户端测试。先查看Android设备的IP地址在设置-关于手机-状态信息里能看到也可以用ADB命令查比在设置里翻要快得多adb shell ip addr show wlan0 | grep inet 拿到类似192.168.1.105这样的地址之后在电脑上打开VNC Viewer。我比较常用RealVNC Viewer因为它的兼容性普遍比TigerVNC和TightVNC好界面也简洁对非标准端口的支持很友好。在地址栏输入192.168.1.105:5900回车它会提示输入密码输入刚才设置的密码很快就能看到Android设备的桌面画面。这里有一个体验细节值得提一下连接的瞬间手机屏幕上会弹出一条屏幕已共享之类的系统提示这是MediaProjection机制的正常反馈不要手滑点掉否则连接会中断。连上之后鼠标点击对应手机屏幕位置键盘输入对应文字。实测在同一个Wi-Fi环境下延迟大概一两百毫秒用来操作App、滑动页面完全没问题。画面默认是竖屏比例如果嫌窗口太大可以在Viewer里设置缩放适配画面会等比缩小到窗口大小。3.3 通过ADB端口转发连接局域网直连虽然简单但实际开发中我用的最多的其实是ADB端口转发。原因有两个一是办公网络经常有各种隔离策略局域网直连不一定通二是走USB线连接非常稳定不容易被系统后台策略干扰性能也更好。先插上USB线确认ADB能看到设备adb devices然后执行端口转发adb forward tcp:15900 tcp:5900这行命令的含义是把电脑上的15900端口收到的所有TCP流量原样转发到Android设备上的5900端口。也就是说VNC客户端连接127.0.0.1:15900实际上等价于连接到了设备的VNC服务。为什么不直接转发5900端口因为5900是VNC默认端口本地可能有其他服务占用用一个高位端口更稳妥。然后用VNC Viewer连接127.0.0.1:15900输入密码就能看到设备画面了。整个链路里VNC数据都走在USB线里不经过系统网卡速度往往比Wi-Fi直连还快画面也更流畅。实测用这种方式看设备画面基本没有可感知的卡顿。如果不想插线Android 11之后的设备可以用无线调试。先到设置-开发者选项-无线调试里开启然后电脑上执行adb pair 192.168.1.105:xxxxx输入屏幕上显示的配对码后再执行adb connect 192.168.1.105:yyyyy连接成功后再执行adb forward命令后续操作就和USB连接模式完全一样了。这套组合在办公场景里非常实用设备放在实验室里你坐在工位上就能无缝接入。4. 踩坑记录与排查清单4.1 几个最典型的问题这一节把我在实际操作中踩过的坑整理一下按出现频率从高到低排列你可以直接拿来做排查手册。第一个问题是连上以后黑屏。出现这个情况绝大多数原因是MediaProjection授权没生效。比如应用弹授权框时被点了拒绝或者设备重启后权限被重置。解决办法是回到droidVNC-NG界面重新点启动让系统重新弹授权框允许之后一般就正常了。还有一种情况是屏幕处于锁屏休眠状态部分设备在屏幕关闭后采集不到画面内容可以先用adb shell svc power stayon true让设备保持常亮然后重新连接。第二个问题是连接后很快断开或者直接在Viewer里报unable to connect。先检查密码和端口有没有输错再确认设备端和电脑端是否真的在同一网络下如果网络隔离了直接改用ADB转发方式如果走的是ADB转发确认adb forward命令执行成功可以用adb forward --list查看当前转发表。还有一个容易被忽略的点VNC服务进程可能已经被Android系统后台杀了。判断方法很简单看设备状态栏上的常驻通知是否还在通知没了基本就是进程没了直接重新启动服务。第三个问题是操作延迟高、画面卡顿。优先检查Wi-Fi信号强度5GHz频段明显比2.4GHz稳定2.4GHz在办公室这种干扰源多的环境里几乎没法用。也可以在VNC Viewer里把画质从自动调整为低画质或高速度模式牺牲一点清晰度换流畅度。如果走的是ADB转发画面一般不会卡真卡的话就要看看是不是电脑资源占用太高了。第四个问题是鼠标点击位置和实际响应位置对不上。这个多见于屏幕分辨率比较特殊的设备或者Viewer做了缩放适配的情况下。解决办法是取消Viewer里的缩放适配用1:1显示模式或者手动调整窗口大小让画面保持原始比例。这个问题在带刘海屏、挖孔屏的设备上尤其明显因为系统UI的显示区域和实际物理分辨率存在偏差。我把常见问题整理成了一个速查表方便你直接保存现象可能原因处理方式黑屏MediaProjection授权未生效重新启动服务并允许授权黑屏屏幕休眠导致采集不到内容svc power stayon true 保持常亮连不上网络隔离或端口错误改用ADB转发方式连接连上秒断后台进程被系统杀掉检查状态栏通知重新启动服务画面卡顿2.4GHz Wi-Fi干扰换5GHz频段或降低画质点击错位Viewer缩放适配导致取消缩放用1:1显示模式4.2 体验优化与几个进阶技巧如果打算把这套方案用在日常工作中下面这几个优化点值得花几分钟配置一下能让整个体验再上一个台阶。第一是后台白名单设置。进入系统设置-应用-找到droidVNC-NG-电池选择无限制同时允许自启动和后台活动。这个步骤在国产ROM上尤其重要否则服务跑几十分钟就悄悄没了等你远程连的时候才发现又断了非常崩溃。如果设备上装了系统清理类的App记得把droidVNC-NG加入清理白名单不然一键清理也会把它干掉。第二是输入文字的问题。VNC客户端上输入英文和数字问题不大但中文输入经常失效因为Android端需要激活对应的输入法才能接收文本。我一般直接在电脑上通过ADB命令输入文本简单可靠adb shell input text hello注意input text不支持直接输入中文。如果一定要远程输入中文建议装一个ADB Keyboard之类的输入法通过ADB广播的方式发送文本这在自动化测试脚本里也经常用到。第三是多设备管理。同时管理多台设备时建议每台Android设备上把VNC端口改成不同的值比如设备A用5901、设备B用5902然后通过adb forward tcp:15901 tcp:5901这样的方式一一对应。在VNC Viewer里把每个连接保存成独立配置命名成设备型号或者测试编号切换起来非常方便不用每次现查IP现填端口。第四点想强调一下安全边界。VNC协议本身默认不加密局域网里玩玩没问题但绝对不要把设备上的5900端口直接映射到公网除非你有完整的认证、加密和访问控制方案否则相当于在公网上裸奔。如果确实需要跨网络访问优先考虑通过ADB转发这种带会话管理的通道而不是直接开端口暴露服务。这套Android VNC Server方案我在实际项目中已经用了大半年现在测试设备出问题时我坐在工位上几秒钟就能切到设备画面不用再一趟一趟跑了。要说它最大的价值其实是把Android设备纳入了标准的VNC工具链无论你用什么平台的VNC客户端都能直接接管设备。对于经常跟设备打交道的朋友来说值得花十几分钟把这套环境搭起来后面用到的机会远比想象中多。这个方向其实还可以继续扩展比如配合自动化脚本在设备重启后自动拉起VNC服务或者把屏幕方向、分辨率按不同的测试用例动态切换这些我后面会再做一轮实验到时候整理出来再分享。本文还有配套的精品资源点击获取 Android VNC Server搭建指南：远程控制与调试的完整实践
简介面向需要远程控制 Android 设备的开发者与测试人员这份 Android VNC Server 资源提供了可在 Android 端运行的 VNC 服务端源码让 PC 通过 VNC Viewer 即可实现连接与设备操控适用于真机调试、自动化测试、演示教学等场景。包内关键编译问题已修复免去自行排查错误的繁琐过程可直接构建并部署使用。压缩包共 174 个文件核心实现以 C 源码84 个 .c与头文件25 个 .h为主同时配有 autoconf/automake 构建脚本、jar 辅助包、版本说明与变更记录等整体体积仅 1.08MB结构紧凑、层次清晰。已有 2554 人学习下载适合需要搭建 Android 远程控制环境、研究 VNC 协议实现或二次开发服务端功能的技术人员。资源包保留了完整的构建配置体系对理解 Android 原生程序编译流程和交叉编译方法也有参考价值同时可作为团队备份基线或方案对比的素材。 前阵子在做多设备自动化测试需要同时盯着好几台Android设备的状态一会儿跑过去看一眼一会儿又跑回去点一下效率低得让人抓狂。后来我在每台待测设备上装了一个VNC服务端人坐在工位上就能用电脑同时看所有设备的画面需要操作的时候鼠标一点就能接管彻底把这个问题解决了。这套方案就是今天要聊的Android VNC Server——在Android设备上跑一个标准的VNC服务端让任意平台的VNC客户端都能连接进来做远程查看和操控。它能解决的场景很明确开发调试、自动化测试监控、给同事演示App效果、临时帮人处理设备问题。不用装厂商私有客户端也不依赖账号体系一套标准VNC协议走天下Windows、macOS、Linux的VNC Viewer都能直接连。适合移动开发、测试、运维以及所有喜欢折腾工具的朋友。下面把从选型到搭建再到排坑的完整过程记录下来按我的实际体验来写。1. 需求场景与方案选型1.1 为什么需要给Android跑VNC服务桌面环境的远程控制几乎是标配Windows有自带的RDPLinux有VNCmacOS有屏幕共享。Android虽然是移动系统但在开发、测试和运维场景里远程查看和操作设备的需求其实非常频繁甚至比桌面端更迫切。我遇到最多的是三类情况。第一类是自动化测试跑Monkey或者Appium的时候你得随时知道设备当前卡在哪个页面、是不是弹了崩溃对话框、CPU是不是被打满。以前每次都要跑到测试架旁边看设备多了根本看不过来。接入VNC之后电脑上开几个窗口切着看就行效率完全不在一个量级。第二类是开发调试在平板上调试某个适配问题但人坐在工位上手边只有电脑操作设备很别扭。VNC连上以后用鼠标键盘直接操控改配置、点按钮、滑动页面都方便很多。第三类是临时协助朋友或者同事手机遇到问题远程指导半天说不清楚让对方装一个VNC服务端你本地用Viewer连过去直接看着屏幕操作解决问题比电话里盲猜高效得多。还有一个很重要的点VNC是开放协议服务端只需要实现RFB协议客户端那一端几乎不用挑Windows、macOS、Linux都有成熟稳定的Viewer甚至手机上也能装Viewer去连别的设备。这意味着方案的通用性极强不依赖任何一家厂商的私有生态也没有账号体系绑定的问题。1.2 主流方案对比与我的选择在确定自建VNC之前我认真比较过几个候选方案这里直接讲结论。第一个是商业远程控制工具比如AirDroid、向日葵这类。体验确实好App装好、注册账号、扫码几步就能连上基本零门槛。但问题也很明显数据要绕一圈第三方服务器有免费版限制而且它解决的是人连人的问题不是程序连设备的问题。如果你想通过标准VNC协议把自己的工具链接进来商业软件做不到。第二个是scrcpy。这个工具我平时用得非常多通过ADB实现屏幕镜像和控制延迟极低、画质极好简直是Android开发者的神器。但它不是服务端形态依赖电脑端跑scrcpy进程手机端只是通过ADB暴露了一个调试服务。如果场景是在一台电脑上通过VNC协议接入另一台电脑正在调试的设备scrcpy就力不从心了。第三个是早期的android-vnc-server。这个老方案要求设备root直接读取framebuffer设备节点抓取屏幕内容然后把帧数据发给VNC客户端。思路很硬核但Android 5.0之后系统对底层显示链路的权限管控越来越严这个项目基本已经废了新设备上跑不起来只适用于老版本系统。最后实际落地的方案是droidVNC-NG。它的核心思路是调用Android官方提供的MediaProjection屏幕采集API不需要root从Android 5.0到Android 14都能稳定运行而且是标准的VNC服务端实现。实测局域网内连接流畅度可以接受画面延迟大概在两三百毫秒级别日常看状态、做操作完全够用。方案是否需要root服务端形态主要限制商业工具AirDroid/向日葵否客户端账号依赖第三方服务器、有免费限制scrcpy否需ADB电脑端进程不是标准VNC监听依赖ADB通道android-vnc-server老方案是设备端服务仅适合Android 5.0之前的系统droidVNC-NG否设备端服务后台可能被系统限制需要调优选droidVNC-NG的原因可以总结成三点不需要root、标准VNC协议、开源可审计。对于需要长期稳定使用的工具这三点缺一不可。2. 搭建前必须搞懂的底层逻辑2.1 droidVNC-NG的工作原理很多人以为VNC就是截屏传图其实底层用的RFB协议Remote FrameBuffer比这稍微复杂一点但理解核心流程就够了不用啃协议文档。Android端的VNC服务端启动之后主要做两件事一是把屏幕内容编码成RFB协议要求的帧格式通过TCP端口发给连接的客户端二是接收客户端传来的鼠标键盘事件转换成Android的InputEvent注入到系统里。简单说就是屏幕传出去操作收进来方向和RDP基本一致。这里最关键的一环是屏幕采集。droidVNC-NG没有用任何系统私有接口而是调用Android 5.0开始提供的MediaProjection API。这个API要求应用在运行过程中弹出一个系统级授权对话框用户点允许之后应用才能拿到一个虚拟显示VirtualDisplay的句柄把屏幕渲染内容输出到Surface上。整个链路大致是屏幕内容 - 虚拟显示 - Surface - 像素缓冲 - RFB编码 - TCP网络端口。之所以要强调授权对话框是因为这个授权不是装完App就永久生效的。设备重启、或者应用进程被系统杀掉之后下次启动服务经常需要重新点一次授权。这一点在实操中非常容易踩坑很多人连上黑屏就卡在这里后面我会专门展开。2.2 网络与权限的几个关键点VNC服务端跑起来之后客户端怎么连进来通常有三种方式按实际使用频率来说我建议你从第二种开始尝试。第一种是局域网直连。设备连上Wi-Fi查看IP地址客户端直接用IP:端口访问。这种方式最简单适合设备在同一个办公网或者家庭网环境。但需要注意有些办公网开了AP隔离手机和电脑虽然连的是同一个Wi-Fi互相之间却完全访问不到这时候就得换第二种方式。第二种是ADB端口转发。设备通过USB线连到电脑上先用adb forward命令把电脑的某个本地端口映射到设备上的5900端口然后客户端只需要连接电脑的本地端口即可。这个方式的优点是数据全程走USB线完全不暴露在局域网里安全性最高而且即使设备没网也能用。我在办公室环境里基本都走这条路。第三种是无线ADB转发。Android 11之后的设备支持无线调试可以先通过ADB配对连接设备然后再做端口转发。这种方式的优点是既不用插线数据依然通过ADB隧道传输不会直接把VNC端口暴露在局域网里兼顾了便利性和安全性。权限方面除了MediaProjection授权国内厂商的ROM普遍有后台进程管理机制VNC服务端如果长期驻留后台很容易被系统当作不常用应用杀掉。解决办法就是把应用加入电池优化白名单、允许自启动和后台活动。这个坑我踩过不止一次服务跑着跑着突然断连排查半天发现是进程被系统回收了。3. 实操从安装到连通的一次完整记录3.1 安装、授权与启动服务第一步是下载droidVNC-NG的APK。项目在GitHub上开源Release页面直接下载最新版安装包装到Android设备上。不用区分手机还是平板只要是Android 5.0以上的设备都可以。装好之后打开应用界面非常简洁。首次启动会弹出系统授权对话框提示是否允许应用录制屏幕之类的权限这里必须点允许否则后面连上也是黑屏。这一步其实是MediaProjection API的系统弹窗属于正常流程不是应用自己画的伪造界面。进入主界面后有几个关键配置项需要确认一下端口默认是5900一般不用改只有同一台设备上跑多实例才需要改。密码设置一个连接密码建议至少8位别用生日这种弱密码。连接类型默认选TCP即可不开TLS的话就不用配置证书省去一堆麻烦。配置好之后点启动按钮状态栏出现一个常驻通知代表服务已经在后台监听了。这里有一个细节启动服务时如果系统又弹了一次授权框记得再点一次允许别直接关掉。启动成功之后我习惯先用ADB确认一下服务真的起来了命令很简单adb shell netstat -tlnp | grep 5900如果看到有进程在监听5900端口说明服务端工作正常可以进入下一步了。3.2 局域网直连与VNC Viewer连接服务端启动后我拿了一台Windows电脑做客户端测试。先查看Android设备的IP地址在设置-关于手机-状态信息里能看到也可以用ADB命令查比在设置里翻要快得多adb shell ip addr show wlan0 | grep inet 拿到类似192.168.1.105这样的地址之后在电脑上打开VNC Viewer。我比较常用RealVNC Viewer因为它的兼容性普遍比TigerVNC和TightVNC好界面也简洁对非标准端口的支持很友好。在地址栏输入192.168.1.105:5900回车它会提示输入密码输入刚才设置的密码很快就能看到Android设备的桌面画面。这里有一个体验细节值得提一下连接的瞬间手机屏幕上会弹出一条屏幕已共享之类的系统提示这是MediaProjection机制的正常反馈不要手滑点掉否则连接会中断。连上之后鼠标点击对应手机屏幕位置键盘输入对应文字。实测在同一个Wi-Fi环境下延迟大概一两百毫秒用来操作App、滑动页面完全没问题。画面默认是竖屏比例如果嫌窗口太大可以在Viewer里设置缩放适配画面会等比缩小到窗口大小。3.3 通过ADB端口转发连接局域网直连虽然简单但实际开发中我用的最多的其实是ADB端口转发。原因有两个一是办公网络经常有各种隔离策略局域网直连不一定通二是走USB线连接非常稳定不容易被系统后台策略干扰性能也更好。先插上USB线确认ADB能看到设备adb devices然后执行端口转发adb forward tcp:15900 tcp:5900这行命令的含义是把电脑上的15900端口收到的所有TCP流量原样转发到Android设备上的5900端口。也就是说VNC客户端连接127.0.0.1:15900实际上等价于连接到了设备的VNC服务。为什么不直接转发5900端口因为5900是VNC默认端口本地可能有其他服务占用用一个高位端口更稳妥。然后用VNC Viewer连接127.0.0.1:15900输入密码就能看到设备画面了。整个链路里VNC数据都走在USB线里不经过系统网卡速度往往比Wi-Fi直连还快画面也更流畅。实测用这种方式看设备画面基本没有可感知的卡顿。如果不想插线Android 11之后的设备可以用无线调试。先到设置-开发者选项-无线调试里开启然后电脑上执行adb pair 192.168.1.105:xxxxx输入屏幕上显示的配对码后再执行adb connect 192.168.1.105:yyyyy连接成功后再执行adb forward命令后续操作就和USB连接模式完全一样了。这套组合在办公场景里非常实用设备放在实验室里你坐在工位上就能无缝接入。4. 踩坑记录与排查清单4.1 几个最典型的问题这一节把我在实际操作中踩过的坑整理一下按出现频率从高到低排列你可以直接拿来做排查手册。第一个问题是连上以后黑屏。出现这个情况绝大多数原因是MediaProjection授权没生效。比如应用弹授权框时被点了拒绝或者设备重启后权限被重置。解决办法是回到droidVNC-NG界面重新点启动让系统重新弹授权框允许之后一般就正常了。还有一种情况是屏幕处于锁屏休眠状态部分设备在屏幕关闭后采集不到画面内容可以先用adb shell svc power stayon true让设备保持常亮然后重新连接。第二个问题是连接后很快断开或者直接在Viewer里报unable to connect。先检查密码和端口有没有输错再确认设备端和电脑端是否真的在同一网络下如果网络隔离了直接改用ADB转发方式如果走的是ADB转发确认adb forward命令执行成功可以用adb forward --list查看当前转发表。还有一个容易被忽略的点VNC服务进程可能已经被Android系统后台杀了。判断方法很简单看设备状态栏上的常驻通知是否还在通知没了基本就是进程没了直接重新启动服务。第三个问题是操作延迟高、画面卡顿。优先检查Wi-Fi信号强度5GHz频段明显比2.4GHz稳定2.4GHz在办公室这种干扰源多的环境里几乎没法用。也可以在VNC Viewer里把画质从自动调整为低画质或高速度模式牺牲一点清晰度换流畅度。如果走的是ADB转发画面一般不会卡真卡的话就要看看是不是电脑资源占用太高了。第四个问题是鼠标点击位置和实际响应位置对不上。这个多见于屏幕分辨率比较特殊的设备或者Viewer做了缩放适配的情况下。解决办法是取消Viewer里的缩放适配用1:1显示模式或者手动调整窗口大小让画面保持原始比例。这个问题在带刘海屏、挖孔屏的设备上尤其明显因为系统UI的显示区域和实际物理分辨率存在偏差。我把常见问题整理成了一个速查表方便你直接保存现象可能原因处理方式黑屏MediaProjection授权未生效重新启动服务并允许授权黑屏屏幕休眠导致采集不到内容svc power stayon true 保持常亮连不上网络隔离或端口错误改用ADB转发方式连接连上秒断后台进程被系统杀掉检查状态栏通知重新启动服务画面卡顿2.4GHz Wi-Fi干扰换5GHz频段或降低画质点击错位Viewer缩放适配导致取消缩放用1:1显示模式4.2 体验优化与几个进阶技巧如果打算把这套方案用在日常工作中下面这几个优化点值得花几分钟配置一下能让整个体验再上一个台阶。第一是后台白名单设置。进入系统设置-应用-找到droidVNC-NG-电池选择无限制同时允许自启动和后台活动。这个步骤在国产ROM上尤其重要否则服务跑几十分钟就悄悄没了等你远程连的时候才发现又断了非常崩溃。如果设备上装了系统清理类的App记得把droidVNC-NG加入清理白名单不然一键清理也会把它干掉。第二是输入文字的问题。VNC客户端上输入英文和数字问题不大但中文输入经常失效因为Android端需要激活对应的输入法才能接收文本。我一般直接在电脑上通过ADB命令输入文本简单可靠adb shell input text hello注意input text不支持直接输入中文。如果一定要远程输入中文建议装一个ADB Keyboard之类的输入法通过ADB广播的方式发送文本这在自动化测试脚本里也经常用到。第三是多设备管理。同时管理多台设备时建议每台Android设备上把VNC端口改成不同的值比如设备A用5901、设备B用5902然后通过adb forward tcp:15901 tcp:5901这样的方式一一对应。在VNC Viewer里把每个连接保存成独立配置命名成设备型号或者测试编号切换起来非常方便不用每次现查IP现填端口。第四点想强调一下安全边界。VNC协议本身默认不加密局域网里玩玩没问题但绝对不要把设备上的5900端口直接映射到公网除非你有完整的认证、加密和访问控制方案否则相当于在公网上裸奔。如果确实需要跨网络访问优先考虑通过ADB转发这种带会话管理的通道而不是直接开端口暴露服务。这套Android VNC Server方案我在实际项目中已经用了大半年现在测试设备出问题时我坐在工位上几秒钟就能切到设备画面不用再一趟一趟跑了。要说它最大的价值其实是把Android设备纳入了标准的VNC工具链无论你用什么平台的VNC客户端都能直接接管设备。对于经常跟设备打交道的朋友来说值得花十几分钟把这套环境搭起来后面用到的机会远比想象中多。这个方向其实还可以继续扩展比如配合自动化脚本在设备重启后自动拉起VNC服务或者把屏幕方向、分辨率按不同的测试用例动态切换这些我后面会再做一轮实验到时候整理出来再分享。本文还有配套的精品资源点击获取