# TCPPC

**Repository Path**: tianjius/tcppc

## Basic Information

- **Project Name**: TCPPC
- **Description**: TCPPC服务器是适用于Windows的管理型开放式服务器，可以对Windows操作系统执行关机，重启，锁机等操作
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2024-07-29
- **Last Updated**: 2025-04-13

## Categories & Tags

**Categories**: web-service

**Tags**: Windows, PHP

## README

# **欢迎使用**TCPPC服务器！

非常感谢你使用TCPPC服务器，接下来我会对服务器的API、配置及文件结构进行详细介绍

***注意：此项目仅能在Windows系统下运行***



[TOC]

## 介绍

TCPPC服务器是适用于Windows的管理型开放式服务器，可以对Windows操作系统执行关机，重启，锁机等操作

TCPPC服务器支持HTTP与WS协议，同时可以对TCPPC的代码进行修改，使其支持linux或其他功能&平台

TCPPC服务器是一款开源的服务器，使用MIT开源协议，开源地址：[https://gitee.com/tianjius/tcppc](https://gitee.com/tianjius/tcppc) 若想帮助我们发展，请积极为我们提Issues并为我们点上Star哦~

### 支持协议

WS、HTTP-GET请求和HTTP-POST请求

### 下载地址

安装包下载地址：[https://ludhianagroupofcolleges-my.sharepoint.com/personal/obsjjpef6_365_liout_com/_layouts/52/download.aspx?share=Een6XSKNiiZAgW5uEC-YDsQBRj9lyC4reWSIZWvUppw5Mw](https://ludhianagroupofcolleges-my.sharepoint.com/personal/obsjjpef6_365_liout_com/_layouts/52/download.aspx?share=Een6XSKNiiZAgW5uEC-YDsQBRj9lyC4reWSIZWvUppw5Mw)

## 文件结构

下面是服务器的文件结构

`根目录`

​    `├── data`

​    `│      ├── tcppc.conf.json //配置文件`

​    `│		 └── connect.pwd  //密码文件`

​    `├── main`

​	`│           ├── api.php //API文件`

​	`│           ├── command.php //命令执行文件`

​	`│           └── network.php  //服务器文件`

   `├── php`

   `│           └── PHP文件`

  `├── command.bat //启动command.php`

  `└── README.md   //此文件`

如果使用了一段时间，那么文件结构可能会如下变化



`根目录`

​    `├── data`

​    `│           ├── tcppc.conf.json //配置文件`

​    `│		   └── connect.pwd  //密码文件`

​    `├── main`

​	`│           ├── api.php //API文件`

​	`│           ├── command.php //命令执行文件`

​	`│           └── network.php  //服务器文件`

​	`├── pid`

​	`│           ├── network.php.pid  //存储进程编号`

​	`├── log`

​	`│           ├── *.log  //Log存储`

​    `├── php`

​    `│           └── PHP文件`

   `├── command.bat //启动command.php`

   `└── README.md //此文件`

需要留意的是 tcppc.conf.json 和 connect.pwd这两个配置文件

 tcppc.conf.json：存储TCPPC服务器的配置，比如启动端口等

 connect.pwd：存储服务器的登录密码，若此文件为空或不存在，则为无密码

tcppc.conf.json：

`{`

  `"log":true,`

  `"port":7161,`

  `"boot_mode":1,`

​	`"is_auth2":[]`

`}`

其中，log这一项为是否开启日志，如果为false，就可能不会出现log文件夹

 port指服务器监听网络请求的端口

boot_mode为启动模式，如果为0则不显示服务器窗口，如果为1或其他数字则显示服务器窗口

is_auth2为用户自定义拦截软件列表，当尝试运行或结束此软件是会要求输入2级密码



connect.pwd：

12345678（示例）

如果需要登录密码的话，直接把密码输入进去就行了

或者，安装程序会在安装结束后询问你是否设置密码

存储格式为明文

auth2.pwd：

二级密码，必须设置，如果没有设置，服务器会提醒你设置

存储格式为md5格式



# API

## 协议

TCPPC服务器开放出三个协议：HTTP-GET、HTTP-POST、WebSocket

### HTTP-GET

其中，HTTP-GET的请求路径：（$api_path$指接入点，$data$指参数）

[http:///127.0.0.1:7161/api/query/$api_path$?$data$=](http:///127.0.0.1:7161/api/query)

### HTTP-POST

HTTP-POST的请求方式及路径：

http:///127.0.0.1:7161/api/post2

向服务器发送JSON或表单数据，如：

type=$api_path$&$data$=

### WebSocket

WebSokcet的请求方式及路径：

ws://127.0.0.1:7161/ws_server

向服务器发送JSON数据，如：

`{"type":"$api_path$","data":$data$}`

### 返回数据

每次向服务器发送有效或无效的数据，服务器都会返回一个与下面类似的JSON结果集

`{`

​	`"code":200,` `//响应代码`

​	`"type":"connect"` `//向服务器请求的类型，与接入点相同`

​	`"data":{` `//返回数据`

​		`"msg":"OK"`

​	`}`

`}`

## 接入点

### 欢迎消息

#### WebSokcket

当客户端连接WS服务器时会自动发送给客户端

#### HTTP

接入点：welcome（无须授权）

#### 返回数据

`{`
  `"code": "200",`
  `"type": "welcome",`
  `"data": {`
    `"msg": "Welcome To TCPPC HTTP Server",`
    `"initialize_auth": {`
      `"had_server_pwd": "true"`
    `},`
    `"server_type": {`
      `"computer_name": "win-123456789",`
      `"server_protocol": "TCPPC",`
      `"version": "2.3.02"`
    `}`
  `}`
`}`

### SerVer_Root Mode（服务器最高管理权限模式）

#### 接入点

server_root

#### 参数

server_root_pwd：服务器启动时显示的密码，配置文件中boot_mode应为1才能看到

server_command：固定为quit_server，关闭服务器

### Connect（授权）

#### 接入点

connect

#### 参数

server_pwd：可选，服务器登录密码

### shutdown（关机）

#### 接入点

shutdown

#### 参数

wait：true或false，指是否开启延时

close：取消关机或重启，true或false

wait_time：延时关机秒数

### reboot（重启）

#### 接入点

reboot

#### 参数

与shutdown相同（但没有close参数）

### locked（锁定）

#### 接入点

locked

#### 参数

无

### run-app（运行软件）

#### 接入点

run_app

#### 参数

app_path：程序路径

print_data：（可选）是否输出程序输出内容，true或false，若为true，服务器将会以Base64编码输出软件输出的内容

parameter：（可选）传递给程序的参数

auth2_pwd：（可选）当执行敏感操作时，需要输入二级密码

### kill-app（结束程序）

#### 接入点

kill_app

#### 参数

kcp：（可选）结束程序的子进程，true或false

force：（可选）强制结束进程，true或false

app_name：（与app_pid任选一）程序的映像名，例如：tasklist.exe

app_pid：（与app_name任选一）程序的进程编号，例如：1234

## 致谢

再次感谢使用TCPPC服务器

下载地址：[https://ludhianagroupofcolleges-my.sharepoint.com/personal/obsjjpef6_365_liout_com/_layouts/52/download.aspx?share=Een6XSKNiiZAgW5uEC-YDsQBRj9lyC4reWSIZWvUppw5Mw](https://ludhianagroupofcolleges-my.sharepoint.com/personal/obsjjpef6_365_liout_com/_layouts/52/download.aspx?share=Een6XSKNiiZAgW5uEC-YDsQBRj9lyC4reWSIZWvUppw5Mw)