dev-vnc 1.0.0__py3-none-any.whl

dev_vnc-1.0.0.dist-info/METADATA

@@ -0,0 +1,281 @@
+Metadata-Version: 2.4
+Name: dev-vnc
+Version: 1.0.0
+Summary: 通用开发用远程桌面服务 - 用于 SSH 远程连接时的 GUI 应用调试
+Author-email: Henry <henry@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/HenryHenry-Space/dev-vnc
+Project-URL: Repository, https://github.com/HenryHenry-Space/dev-vnc
+Project-URL: Documentation, https://github.com/HenryHenry-Space/dev-vnc/blob/main/README.md
+Keywords: vnc,remote-desktop,development,gui,novnc,xvfb
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Desktop Environment
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: license-file
+
+# Dev VNC Server
+
+🖥️ 通用开发用远程桌面服务 - 用于 SSH 远程连接时的 GUI 应用调试  
+🖥️ A general-purpose remote desktop service for development, designed for GUI debugging over SSH
+
+## 功能特点 / Features
+
+- 🚀 一键启动虚拟桌面环境 / One-click virtual desktop startup
+- 🌐 支持浏览器访问 (noVNC) / Browser access via noVNC
+- 🔌 支持 VNC 客户端连接 / VNC client support
+- ⚙️ 可配置分辨率、端口、窗口管理器 / Configurable resolution, ports, and window manager
+- 🐍 提供 Python CLI 接口 / Python CLI included
+- 📦 易于安装和管理 / Easy to install and manage
+
+## 快速开始 / Quick Start
+
+### 安装 / Install
+
+```bash
+# 克隆项目 / Clone repository
+cd /home/henry/workspace/dev_app_vnc
+
+# 运行安装脚本 / Run install script
+./scripts/install.sh
+```
+
+### 使用 / Usage
+
+```bash
+# 启动远程桌面 / Start remote desktop
+dev-vnc start
+
+# 查看状态 / Show status
+dev-vnc status
+
+# 查看访问信息 / Show access info
+dev-vnc info
+
+# 在 VNC 环境中运行程序 / Run command in VNC
+dev-vnc run python my_gui_app.py
+
+# 停止服务 / Stop service
+dev-vnc stop
+```
+
+## 访问方式 / Access
+
+### 浏览器访问 (推荐) / Browser (recommended)
+
+启动服务后，打开浏览器访问 / After starting the service, open in browser:
+- `http://localhost:6080/vnc.html`
+- `http://<服务器IP>:6080/vnc.html`
+
+### VNC 客户端 / VNC Client
+
+使用任意 VNC 客户端连接 / Connect with any VNC client:
+- 地址 / Address: `localhost:5999` 或 `<服务器IP>:5999`
+- 密码 / Password: `devvnc123` (可配置 / configurable)
+
+## 配置 / Configuration
+
+### 配置文件 / Config file
+
+配置文件位于 `~/.config/dev-vnc/config.env` / Config file location: `~/.config/dev-vnc/config.env`
+
+```bash
+# 显示器编号 / Display number
+DEV_VNC_DISPLAY=99
+
+# VNC 端口 / VNC port
+DEV_VNC_PORT=5999
+
+# noVNC Web 端口 / noVNC web port
+DEV_VNC_NOVNC_PORT=6080
+
+# 分辨率 / Resolution
+DEV_VNC_RESOLUTION=1920x1080x24
+
+# VNC 密码 / VNC password
+DEV_VNC_PASSWORD=devvnc123
+
+# 窗口管理器 (fluxbox, openbox, i3) / Window manager
+DEV_VNC_WM=fluxbox
+```
+
+### 环境变量 / Environment variables
+
+也可以通过环境变量覆盖配置 / Override with environment variables:
+
+```bash
+DEV_VNC_RESOLUTION=2560x1440x24 dev-vnc start
+```
+
+## 命令参考 / Command reference
+
+| 命令 / Command | 说明 / Description |
+|------|------|
+| `dev-vnc start` | 启动远程桌面服务 / Start remote desktop |
+| `dev-vnc stop` | 停止远程桌面服务 / Stop remote desktop |
+| `dev-vnc restart` | 重启服务 / Restart service |
+| `dev-vnc status` | 显示服务状态 / Show status |
+| `dev-vnc info` | 显示访问信息 / Show access info |
+| `dev-vnc logs [type]` | 显示日志 (vnc/novnc/all) / Show logs |
+| `dev-vnc run <cmd>` | 在 VNC 环境中运行命令 / Run command in VNC |
+| `dev-vnc config` | 显示当前配置 / Show configuration |
+| `dev-vnc install-deps` | 安装系统依赖 / Install dependencies |
+| `dev-vnc help` | 显示帮助信息 / Show help |
+
+## Python CLI
+
+也可以使用 Python CLI / You can also use the Python CLI:
+
+```bash
+# 安装 / Install
+pip install -e .
+
+# 使用 / Usage
+devvnc start
+devvnc status
+devvnc run python my_app.py
+```
+
+## 系统要求 / System requirements
+
+### 支持的操作系统 / Supported OS
+
+- Ubuntu / Debian
+- Fedora / CentOS / RHEL
+- Arch Linux
+
+### 依赖 / Dependencies
+
+- Xvfb
+- x11vnc
+- fluxbox (或其他窗口管理器)
+- noVNC
+- websockify
+- Python 3.8+
+
+## 典型使用场景 / Typical use cases
+
+### 远程 GUI 开发 / Remote GUI development
+
+在 SSH 连接的远程服务器上调试 GUI 应用 / Debug GUI apps over SSH:
+
+```bash
+# SSH 连接到服务器 / SSH into server
+ssh user@server
+
+# 启动远程桌面 / Start remote desktop
+dev-vnc start
+
+# 在本地浏览器打开 / Open in local browser
+
+# 运行 GUI 应用 / Run GUI app
+dev-vnc run python my_gui_app.py
+```
+
+### CI/CD 中的 GUI 测试 / GUI testing in CI/CD
+
+在无头环境中运行 GUI 测试 / Run GUI tests in headless environments:
+
+```bash
+# 启动虚拟桌面 / Start virtual desktop
+dev-vnc start
+
+# 运行 GUI 测试 / Run GUI tests
+dev-vnc run pytest tests/gui/
+```
+
+### 容器中的 GUI 应用 / GUI apps in containers
+
+在 Docker 容器中运行 GUI 应用 / Run GUI apps in Docker:
+
+```dockerfile
+FROM ubuntu:22.04
+
+# 安装依赖 / Install dependencies
+RUN apt-get update && apt-get install -y \
+    xvfb x11vnc fluxbox novnc websockify
+
+# 复制 dev-vnc / Copy dev-vnc
+COPY . /app/dev-vnc
+RUN /app/dev-vnc/scripts/install.sh
+
+EXPOSE 5999 6080
+
+CMD ["dev-vnc", "start"]
+```
+
+## 项目结构 / Project structure
+
+```
+dev_app_vnc/
+├── README.md
+├── pyproject.toml
+├── config/
+│   └── config.env.example
+├── devvnc/
+│   ├── __init__.py
+│   ├── cli.py
+│   ├── server.py
+│   └── config.py
+├── scripts/
+│   ├── dev-vnc-server.sh
+│   └── install.sh
+├── tests/
+│   └── test_server.py
+└── docs/
+    └── ...
+```
+
+## 故障排除 / Troubleshooting
+
+### 服务无法启动 / Service won't start
+
+1. 检查依赖是否安装 / Check dependencies:
+   ```bash
+   dev-vnc install-deps
+   ```
+
+2. 检查端口是否被占用 / Check port usage:
+   ```bash
+   netstat -tlnp | grep -E '5999|6080'
+   ```
+
+3. 查看日志 / View logs:
+   ```bash
+   dev-vnc logs
+   ```
+
+### 无法连接 / Cannot connect
+
+1. 检查防火墙设置 / Check firewall:
+   ```bash
+   sudo ufw allow 5999
+   sudo ufw allow 6080
+   ```
+
+2. 确认服务正在运行 / Confirm service is running:
+   ```bash
+   dev-vnc status
+   ```
+
+## License
+
+MIT License

dev_vnc-1.0.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+dev_vnc-1.0.0.dist-info/licenses/LICENSE,sha256=Mj3Envh08AqG-T_wD4DEsSQyvMuHlCpexHW6MGPNgqE,1064
+devvnc/__init__.py,sha256=61LvlgTLyY419ScFFhdcGGTN3piUzgg5Hd9SGQ9mWeI,270
+devvnc/cli.py,sha256=uxVrKPkWDX30GtPsxrZrniaXV5RnO8Ui2WQ0za2sQEQ,3481
+devvnc/config.py,sha256=anqx4PgbcFpN8nN7mOYAnMqdjYNOitXuzflhy1j2Qwo,4963
+devvnc/server.py,sha256=h4UW6pFiewMNe-bCC5aDaTTiVu713tM7DWzRcIeC-aw,14523
+dev_vnc-1.0.0.dist-info/METADATA,sha256=ms2V07CA5vUaIahoHr5jwGRvWeqVa6xJmpGfU0t-6G0,7134
+dev_vnc-1.0.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+dev_vnc-1.0.0.dist-info/entry_points.txt,sha256=z_grZxOt_qi3F9HqdyyZI9eJPJV9T0uldJ5QNx2FWT0,43
+dev_vnc-1.0.0.dist-info/top_level.txt,sha256=AEN9P3W06V9MUhGFU9RfuSDk5znjXAQBpS00buKUYpw,7
+dev_vnc-1.0.0.dist-info/RECORD,,

dev_vnc-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dev_vnc-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devvnc = devvnc.cli:main

dev_vnc-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 Henry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dev_vnc-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+devvnc

devvnc/__init__.py

@@ -0,0 +1,11 @@
+"""
+Dev VNC Server - 通用开发用远程桌面服务 / Remote desktop service for development
+"""
+
+__version__ = "1.0.0"
+__author__ = "Henry"
+
+from .server import DevVNCServer
+from .config import DevVNCConfig
+
+__all__ = ["DevVNCServer", "DevVNCConfig", "__version__"]

devvnc/cli.py

@@ -0,0 +1,123 @@
+"""
+Dev VNC Server - 命令行接口 / Command-line interface
+"""
+
+import argparse
+import sys
+from typing import List, Optional
+
+from . import __version__
+from .server import DevVNCServer
+
+
+def main(args: Optional[List[str]] = None) -> int:
+    """主入口 / Entry point"""
+    parser = argparse.ArgumentParser(
+        prog="devvnc",
+        description="Dev VNC Server - 通用开发用远程桌面服务",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+示例:
+  devvnc start                  # 启动服务
+  devvnc stop                   # 停止服务
+  devvnc status                 # 查看状态
+  devvnc run python app.py      # 在 VNC 环境中运行命令
+
+环境变量:
+  DEV_VNC_DISPLAY      显示器编号 (默认: 99)
+  DEV_VNC_PORT         VNC 端口 (默认: 5999)
+  DEV_VNC_NOVNC_PORT   noVNC 端口 (默认: 6080)
+  DEV_VNC_RESOLUTION   分辨率 (默认: 1920x1080x24)
+  DEV_VNC_PASSWORD     VNC 密码 (默认: devvnc123)
+  DEV_VNC_WM           窗口管理器 (默认: fluxbox)
+"""
+    )
+    
+    parser.add_argument(
+        "--version", "-V",
+        action="version",
+        version=f"%(prog)s {__version__}"
+    )
+    
+    subparsers = parser.add_subparsers(dest="command", help="可用命令")
+    
+    # start
+    start_parser = subparsers.add_parser("start", help="启动远程桌面服务")
+    
+    # stop
+    stop_parser = subparsers.add_parser("stop", help="停止远程桌面服务")
+    
+    # restart
+    restart_parser = subparsers.add_parser("restart", help="重启远程桌面服务")
+    
+    # status
+    status_parser = subparsers.add_parser("status", help="显示服务状态")
+    
+    # info
+    info_parser = subparsers.add_parser("info", help="显示访问信息")
+    
+    # config
+    config_parser = subparsers.add_parser("config", help="显示当前配置")
+    
+    # logs
+    logs_parser = subparsers.add_parser("logs", help="显示日志")
+    logs_parser.add_argument(
+        "type",
+        nargs="?",
+        default="all",
+        choices=["vnc", "novnc", "all"],
+        help="日志类型"
+    )
+    
+    # run
+    run_parser = subparsers.add_parser("run", help="在 VNC 环境中运行命令")
+    run_parser.add_argument("cmd", nargs=argparse.REMAINDER, help="要运行的命令")
+    
+    # 解析参数 / Parse arguments
+    parsed = parser.parse_args(args)
+    
+    if not parsed.command:
+        parser.print_help()
+        return 0
+    
+    # 创建服务器实例 / Create server instance
+    server = DevVNCServer()
+    
+    # 执行命令 / Execute command
+    if parsed.command == "start":
+        return 0 if server.start() else 1
+    
+    elif parsed.command == "stop":
+        return 0 if server.stop() else 1
+    
+    elif parsed.command == "restart":
+        return 0 if server.restart() else 1
+    
+    elif parsed.command == "status":
+        server.show_status()
+        server.show_info()
+        return 0
+    
+    elif parsed.command == "info":
+        server.show_info()
+        return 0
+    
+    elif parsed.command == "config":
+        server.show_config()
+        return 0
+    
+    elif parsed.command == "logs":
+        server.show_logs(parsed.type)
+        return 0
+    
+    elif parsed.command == "run":
+        if not parsed.cmd:
+            print("❌ 请指定要运行的命令 / Please specify a command to run")
+            return 1
+        return server.run_command(parsed.cmd)
+    
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

devvnc/config.py

@@ -0,0 +1,126 @@
+"""
+Dev VNC Server 配置管理 / Configuration management
+"""
+
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Optional
+
+
+@dataclass
+class DevVNCConfig:
+    """VNC 服务器配置 / VNC server configuration"""
+    
+    # 显示器配置 / Display settings
+    display_num: int = 99
+    vnc_port: int = 5999
+    novnc_port: int = 6080
+    resolution: str = "1920x1080x24"
+    
+    # 认证 / Authentication
+    password: str = "devvnc123"
+    
+    # 窗口管理器 / Window manager
+    window_manager: str = "fluxbox"
+    
+    # 目录 / Directories
+    log_dir: Path = field(default_factory=lambda: Path.home() / ".dev-vnc" / "logs")
+    run_dir: Path = field(default_factory=lambda: Path.home() / ".dev-vnc" / "run")
+    config_dir: Path = field(default_factory=lambda: Path.home() / ".config" / "dev-vnc")
+    
+    @classmethod
+    def from_env(cls) -> "DevVNCConfig":
+        """从环境变量加载配置 / Load config from environment"""
+        config = cls()
+        
+    # 先尝试加载配置文件 / Try loading config file first
+        config_file = os.environ.get(
+            "DEV_VNC_CONFIG",
+            str(Path.home() / ".config" / "dev-vnc" / "config.env")
+        )
+        
+        if os.path.exists(config_file):
+            config._load_env_file(config_file)
+        
+    # 环境变量覆盖 / Override with environment variables
+        config.display_num = int(os.environ.get("DEV_VNC_DISPLAY", config.display_num))
+        config.vnc_port = int(os.environ.get("DEV_VNC_PORT", config.vnc_port))
+        config.novnc_port = int(os.environ.get("DEV_VNC_NOVNC_PORT", config.novnc_port))
+        config.resolution = os.environ.get("DEV_VNC_RESOLUTION", config.resolution)
+        config.password = os.environ.get("DEV_VNC_PASSWORD", config.password)
+        config.window_manager = os.environ.get("DEV_VNC_WM", config.window_manager)
+        
+        if log_dir := os.environ.get("DEV_VNC_LOG_DIR"):
+            config.log_dir = Path(log_dir)
+        if run_dir := os.environ.get("DEV_VNC_RUN_DIR"):
+            config.run_dir = Path(run_dir)
+            
+        return config
+    
+    def _load_env_file(self, filepath: str) -> None:
+        """加载 .env 文件 / Load .env file"""
+        try:
+            with open(filepath, "r") as f:
+                for line in f:
+                    line = line.strip()
+                    if line and not line.startswith("#") and "=" in line:
+                        key, value = line.split("=", 1)
+                        key = key.strip()
+                        value = value.strip().strip('"').strip("'")
+                        
+                        # 展开 $HOME / Expand $HOME
+                        value = value.replace("$HOME", str(Path.home()))
+                        
+                        if key == "DEV_VNC_DISPLAY":
+                            self.display_num = int(value)
+                        elif key == "DEV_VNC_PORT":
+                            self.vnc_port = int(value)
+                        elif key == "DEV_VNC_NOVNC_PORT":
+                            self.novnc_port = int(value)
+                        elif key == "DEV_VNC_RESOLUTION":
+                            self.resolution = value
+                        elif key == "DEV_VNC_PASSWORD":
+                            self.password = value
+                        elif key == "DEV_VNC_WM":
+                            self.window_manager = value
+                        elif key == "DEV_VNC_LOG_DIR":
+                            self.log_dir = Path(value)
+                        elif key == "DEV_VNC_RUN_DIR":
+                            self.run_dir = Path(value)
+        except Exception:
+            pass  # 忽略解析错误 / Ignore parse errors
+    
+    @property
+    def display(self) -> str:
+        """返回 DISPLAY 环境变量值 / Return DISPLAY env value"""
+        return f":{self.display_num}"
+    
+    @property
+    def pid_file(self) -> Path:
+        """PID 文件路径 / PID file path"""
+        return self.run_dir / "server.pid"
+    
+    def ensure_dirs(self) -> None:
+        """确保所有目录存在 / Ensure directories exist"""
+        self.log_dir.mkdir(parents=True, exist_ok=True)
+        self.run_dir.mkdir(parents=True, exist_ok=True)
+        self.config_dir.mkdir(parents=True, exist_ok=True)
+        
+    # VNC 目录 / VNC directory
+        vnc_dir = Path.home() / ".vnc"
+        vnc_dir.mkdir(exist_ok=True)
+    
+    def to_dict(self) -> dict:
+        """转换为字典 / Convert to dict"""
+        return {
+            "display_num": self.display_num,
+            "vnc_port": self.vnc_port,
+            "novnc_port": self.novnc_port,
+            "resolution": self.resolution,
+            "password": self.password,
+            "window_manager": self.window_manager,
+            "log_dir": str(self.log_dir),
+            "run_dir": str(self.run_dir),
+            "config_dir": str(self.config_dir),
+        }

devvnc/server.py

@@ -0,0 +1,378 @@
+"""
+Dev VNC Server - 服务器核心实现 / Core server implementation
+"""
+
+import os
+import socket
+import subprocess
+import time
+from pathlib import Path
+from typing import Optional, List, Dict
+
+from .config import DevVNCConfig
+
+
+class DevVNCServer:
+    """VNC 远程桌面服务器 / VNC remote desktop server"""
+    
+    def __init__(self, config: Optional[DevVNCConfig] = None):
+        self.config = config or DevVNCConfig.from_env()
+        self._processes: Dict[str, subprocess.Popen] = {}
+    
+    def is_running(self) -> bool:
+        """检查服务是否正在运行 / Check whether the service is running"""
+        if self.config.pid_file.exists():
+            try:
+                pid = int(self.config.pid_file.read_text().strip())
+                # 检查进程是否存在 / Check whether the process exists
+                os.kill(pid, 0)
+                return True
+            except (ProcessLookupError, ValueError):
+                pass
+        return False
+    
+    def get_status(self) -> Dict[str, bool]:
+        """获取各组件状态 / Get component status"""
+        status = {
+            "xvfb": False,
+            "x11vnc": False,
+            "novnc": False,
+            "window_manager": False,
+        }
+        
+    # 检查 Xvfb / Check Xvfb
+        status["xvfb"] = self._check_process(f"Xvfb :{self.config.display_num}")
+        
+    # 检查 x11vnc / Check x11vnc
+        status["x11vnc"] = self._check_process(f"x11vnc.*:{self.config.display_num}")
+        
+    # 检查 websockify (noVNC) / Check websockify (noVNC)
+        status["novnc"] = self._check_process(f"websockify.*{self.config.novnc_port}")
+        
+    # 检查窗口管理器 / Check window manager
+        status["window_manager"] = self._check_process(self.config.window_manager)
+        
+        return status
+    
+    def _check_process(self, pattern: str) -> bool:
+        """检查进程是否存在 / Check whether a process exists"""
+        try:
+            result = subprocess.run(
+                ["pgrep", "-f", pattern],
+                capture_output=True,
+                text=True
+            )
+            return result.returncode == 0
+        except Exception:
+            return False
+    
+    def _kill_process(self, pattern: str) -> None:
+        """终止匹配的进程 / Terminate matching processes"""
+        try:
+            subprocess.run(
+                ["pkill", "-f", pattern],
+                capture_output=True
+            )
+        except Exception:
+            pass
+    
+    def start(self) -> bool:
+        """启动服务 / Start the service"""
+        if self.is_running():
+            print("⚠️  服务已在运行 / Service is already running")
+            return True
+        
+        self.config.ensure_dirs()
+        self._check_dependencies()
+        self._setup_vnc_password()
+        
+        print("\n🚀 启动远程桌面服务... / Starting remote desktop service...\n")
+        
+        # 清理旧进程 / Clean up old processes
+        self._cleanup()
+        time.sleep(1)
+        
+        try:
+            # 1. 启动 Xvfb / Start Xvfb
+            print(f"📺 启动虚拟显示器 (Display :{self.config.display_num})... / Starting virtual display")
+            self._start_xvfb()
+            time.sleep(2)
+            
+            # 2. 启动窗口管理器 / Start window manager
+            print(f"🪟 启动窗口管理器 ({self.config.window_manager})... / Starting window manager")
+            self._start_window_manager()
+            time.sleep(1)
+            
+            # 3. 启动 VNC / Start VNC
+            print(f"🔌 启动 VNC 服务器 (端口 {self.config.vnc_port})... / Starting VNC server")
+            self._start_vnc()
+            time.sleep(1)
+            
+            # 4. 启动 noVNC / Start noVNC
+            print(f"🌐 启动 noVNC Web 服务器 (端口 {self.config.novnc_port})... / Starting noVNC web server")
+            self._start_novnc()
+            time.sleep(1)
+            
+            # 保存 PID / Save PID
+            self.config.pid_file.write_text(str(os.getpid()))
+            
+            print("\n✅ 远程桌面服务已成功启动！ / Remote desktop service started!")
+            self.show_info()
+            return True
+            
+        except Exception as e:
+            print(f"\n❌ 启动失败: {e} / Start failed")
+            self._cleanup()
+            return False
+    
+    def stop(self) -> bool:
+        """停止服务 / Stop the service"""
+        print("\n🛑 停止远程桌面服务... / Stopping remote desktop service...")
+        
+        self._cleanup()
+        
+        # 清理 PID 文件 / Clean PID files
+        for pid_file in self.config.run_dir.glob("*.pid"):
+            pid_file.unlink(missing_ok=True)
+        
+        print("✅ 远程桌面服务已停止 / Remote desktop service stopped")
+        return True
+    
+    def restart(self) -> bool:
+        """重启服务 / Restart the service"""
+        self.stop()
+        time.sleep(2)
+        return self.start()
+    
+    def _cleanup(self) -> None:
+        """清理所有相关进程 / Clean all related processes"""
+        self._kill_process(f"Xvfb :{self.config.display_num}")
+        self._kill_process(f"x11vnc.*:{self.config.display_num}")
+        self._kill_process(f"websockify.*{self.config.novnc_port}")
+        self._kill_process(self.config.window_manager)
+    
+    def _check_dependencies(self) -> None:
+        """检查依赖 / Check dependencies"""
+        missing = []
+        
+        for cmd in ["Xvfb", "x11vnc", "websockify"]:
+            if not self._command_exists(cmd):
+                missing.append(cmd)
+        
+        if not self._command_exists(self.config.window_manager):
+            missing.append(self.config.window_manager)
+        
+        if missing:
+            raise RuntimeError(
+                f"缺少依赖: {', '.join(missing)} / Missing dependencies\n"
+                f"请运行: dev-vnc install-deps / Please run: dev-vnc install-deps"
+            )
+    
+    def _command_exists(self, cmd: str) -> bool:
+        """检查命令是否存在 / Check whether a command exists"""
+        try:
+            result = subprocess.run(
+                ["which", cmd],
+                capture_output=True
+            )
+            return result.returncode == 0
+        except Exception:
+            return False
+    
+    def _setup_vnc_password(self) -> None:
+        """设置 VNC 密码 / Set VNC password"""
+        passwd_file = Path.home() / ".vnc" / "passwd"
+        
+        if not passwd_file.exists():
+            try:
+                subprocess.run(
+                    ["x11vnc", "-storepasswd", self.config.password, str(passwd_file)],
+                    capture_output=True,
+                    text=True,
+                    input="y\n"
+                )
+            except Exception:
+                pass
+    
+    def _start_xvfb(self) -> None:
+        """启动 Xvfb / Start Xvfb"""
+        cmd = [
+            "Xvfb",
+            f":{self.config.display_num}",
+            "-screen", "0", self.config.resolution
+        ]
+        
+        proc = subprocess.Popen(
+            cmd,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL
+        )
+        self._processes["xvfb"] = proc
+        self._save_pid("xvfb", proc.pid)
+    
+    def _start_window_manager(self) -> None:
+        """启动窗口管理器 / Start window manager"""
+        env = os.environ.copy()
+        env["DISPLAY"] = self.config.display
+        
+        proc = subprocess.Popen(
+            [self.config.window_manager],
+            env=env,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL
+        )
+        self._processes["wm"] = proc
+        self._save_pid("wm", proc.pid)
+    
+    def _start_vnc(self) -> None:
+        """启动 VNC 服务器 / Start VNC server"""
+        passwd_file = Path.home() / ".vnc" / "passwd"
+        log_file = self.config.log_dir / "x11vnc.log"
+        
+        cmd = [
+            "x11vnc",
+            "-display", self.config.display,
+            "-forever",
+            "-shared",
+            "-rfbport", str(self.config.vnc_port),
+            "-rfbauth", str(passwd_file),
+            "-bg",
+            "-o", str(log_file)
+        ]
+        
+        subprocess.run(cmd, capture_output=True)
+    
+    def _start_novnc(self) -> None:
+        """启动 noVNC / Start noVNC"""
+    # 查找 noVNC 路径 / Find noVNC path
+        novnc_paths = [
+            "/usr/share/novnc",
+            "/usr/share/javascript/novnc",
+            "/usr/share/webapps/novnc",
+        ]
+        
+        novnc_path = None
+        for path in novnc_paths:
+            if os.path.isdir(path):
+                novnc_path = path
+                break
+        
+        if not novnc_path:
+            print("⚠️  noVNC 未找到，仅提供 VNC 连接 / noVNC not found, VNC only")
+            return
+        
+        log_file = self.config.log_dir / "websockify.log"
+        
+        with open(log_file, "w") as f:
+            proc = subprocess.Popen(
+                [
+                    "websockify",
+                    f"--web={novnc_path}",
+                    str(self.config.novnc_port),
+                    f"localhost:{self.config.vnc_port}"
+                ],
+                stdout=f,
+                stderr=f
+            )
+            self._processes["novnc"] = proc
+            self._save_pid("novnc", proc.pid)
+    
+    def _save_pid(self, name: str, pid: int) -> None:
+        """保存 PID / Save PID"""
+        pid_file = self.config.run_dir / f"{name}.pid"
+        pid_file.write_text(str(pid))
+    
+    def get_local_ip(self) -> str:
+        """获取本机 IP 地址 / Get local IP address"""
+        try:
+            s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+            s.connect(("8.8.8.8", 80))
+            ip = s.getsockname()[0]
+            s.close()
+            return ip
+        except Exception:
+            return "localhost"
+    
+    def show_info(self) -> None:
+        """显示访问信息 / Show access information"""
+        local_ip = self.get_local_ip()
+        
+        print("""
+╔══════════════════════════════════════════════════════════════╗
+║                 🖥️  远程桌面访问信息                         ║
+║                 🖥️  Remote Desktop Access                    ║
+╚══════════════════════════════════════════════════════════════╝
+""")
+        print("  📍 浏览器访问 (推荐) / Browser access (recommended):")
+        print(f"     http://{local_ip}:{self.config.novnc_port}/vnc.html")
+        print(f"     http://localhost:{self.config.novnc_port}/vnc.html (本机 / local)")
+        print()
+        print("  🔌 VNC 客户端连接 / VNC client:")
+        print(f"     地址 / Address: {local_ip}:{self.config.vnc_port}")
+        print(f"     密码 / Password: {self.config.password}")
+        print()
+        print("  🚀 在远程桌面中运行 GUI 程序 / Run GUI apps in remote desktop:")
+        print(f"     export DISPLAY={self.config.display}")
+        print("     your-gui-application")
+        print()
+        print("  💡 快捷命令 / Quick command:")
+        print("     devvnc run <command>")
+        print()
+    
+    def show_status(self) -> None:
+        """显示状态 / Show status"""
+        status = self.get_status()
+        
+        print("""
+╔══════════════════════════════════════════════════════════════╗
+║                    📊 服务状态                              ║
+║                    📊 Service Status                         ║
+╚══════════════════════════════════════════════════════════════╝
+""")
+        
+        def status_icon(running: bool) -> str:
+            return "✅ 运行中 / Running" if running else "❌ 未运行 / Stopped"
+        
+        print(f"  Xvfb:           {status_icon(status['xvfb'])}")
+        print(f"  x11vnc:         {status_icon(status['x11vnc'])}")
+        print(f"  noVNC:          {status_icon(status['novnc'])}")
+        print(f"  {self.config.window_manager}:       {status_icon(status['window_manager'])}")
+        print()
+    
+    def show_config(self) -> None:
+        """显示配置 / Show configuration"""
+        print("""
+╔══════════════════════════════════════════════════════════════╗
+║                    ⚙️  当前配置                              ║
+║                    ⚙️  Current Configuration                  ║
+╚══════════════════════════════════════════════════════════════╝
+""")
+        for key, value in self.config.to_dict().items():
+            print(f"  {key}: {value}")
+        print()
+    
+    def show_logs(self, log_type: str = "all") -> None:
+        """显示日志 / Show logs"""
+        if log_type in ("vnc", "all"):
+            vnc_log = self.config.log_dir / "x11vnc.log"
+            if vnc_log.exists():
+                print("=== VNC 日志 / VNC Logs ===")
+                print(vnc_log.read_text()[-5000:])  # 最后 5000 字符 / Last 5000 chars
+        
+        if log_type in ("novnc", "all"):
+            novnc_log = self.config.log_dir / "websockify.log"
+            if novnc_log.exists():
+                print("\n=== noVNC 日志 / noVNC Logs ===")
+                print(novnc_log.read_text()[-5000:])
+    
+    def run_command(self, command: List[str]) -> int:
+        """在 VNC 环境中运行命令 / Run command in VNC environment"""
+        if not self.is_running():
+            print("❌ 服务未运行，请先执行: devvnc start / Service not running, run: devvnc start")
+            return 1
+        
+        env = os.environ.copy()
+        env["DISPLAY"] = self.config.display
+        
+        result = subprocess.run(command, env=env)
+        return result.returncode