# ws-scrcpy

**Repository Path**: gtinlian/ws-scrcpy

## Basic Information

- **Project Name**: ws-scrcpy
- **Description**: 远程管理手机的项目
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://android.o78k.cn/admin
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-13
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

# 修改内容
```
 项目基于开源的ws-scrcpy定制了适合远程控制的功能
 实现基于配置的认证机制，支持url地址认证+账号密码认证
 调试，添加基于vscode的开发调试配置，并自持自动更新，服务自动重启等功能
 修改页面，控制栏使用悬浮按钮控制，让手机页面能够好的铺满当前页面
 页面铺满，将页面根据当前页面宽高的最大比例机型铺满，让手机客户端体验更佳
```
# 程序功能介绍
* 登录页面
![img](./docs/login.png)

* 手机列表
![img](./docs/home.png)

* 远程手机
![img](./docs/control.png)

***
#  直接在系统上部署
* 添加配置文件
```
  配置文件config.json
    username: 用户名
    password: 密码
    authentication: url地址认证
```

* 修改登录信息
```
    scrcpy-config
    根据提示输入用户名和密码
```

* 部署运行
```
  install.sh 安装部署脚本
  start.sh 启动脚本,支持deamon参数后台启动
    bash start.sh # 前台启动
    bash start.sh deamon # 后台启动
```

***
#  基于容器构建

* 容器构建
```
  # 构建容器
  docker build -t ws-scrcpy  .

  # 默认运行， 自动生成登录账号密码， 通过docker logs [containerName|containerId] 命令查看
  docker run -d -p 8000:8000    --restart=always  --device=/dev/bus/usb:/dev/bus/usb   ws-scrcpy

  # 配置账号密码和认证路径
  docker run -d -p 8000:8000    -e SCRCPY_URL=app \
    -e SCRCPY_USER=admin \
    -e SCRCPY_PASSWORD=admin \
    --restart=always  \
    --device=/dev/bus/usb:/dev/bus/usb   ws-scrcpy

   登录 http://[ip]/app
   配置用户名: admin
   配置密码: admin
```


* 使用docker-compose运行
```
   安装docker + docker-compose 环境或podman 环境
   在docker-compose.yaml 中已经配置镜像构建和运行参数
   直接运行 docker-compose up -d 即可
   如需要修改登录账号密码， 请修改docker-compose.yaml 中环境变量
```
***