https://github.com/drunkdream/pytmate

Python implementation of tmate（内网终端分享、在线调试Github Actions）
https://github.com/drunkdream/pytmate

onlinedebug shell

Last synced: 6 days ago
JSON representation

Python implementation of tmate（内网终端分享、在线调试Github Actions）

• Host: GitHub
• URL: https://github.com/drunkdream/pytmate
• Owner: drunkdream
• Created: 2020-10-02T17:24:12.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-06-29T15:21:51.000Z (over 2 years ago)
• Last Synced: 2024-11-05T18:57:36.633Z (13 days ago)
• Topics: onlinedebug, shell
• Language: Python
• Homepage:
• Size: 51.8 KB
• Stars: 8
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# pytmate

## 什么是tmate

[tmate](https://tmate.io/)是一款可以用于终端分享的工具，同时也提供了平台能力，用户可以使用平台将内网中的终端分享到外网访问。

## 什么是pytmate

tmate本身只支持类Unix系统（MacOS、Linux等），不支持Windows。而pytmate使用纯Python开发，可以支持全系统，使用也更加方便。

## 环境要求

* Windows 7以上（推荐使用`Windows 10 1809`以上，低版本不支持`pty`）

* Linux

* MacOS

Python版本要求`>=3.6`

## 安装

```bash

$ pip install tmate

```

## 如何使用

```bash

$ tmate

[TMateClient] Connect SSH server ssh.tmate.io:22...

[Notify] web session read only: https://tmate.io/t/ro-Q5VKGqmt24FxTnUqtdzCZHhtR

[Notify] ssh session read only: ssh [email protected]

[Notify] web session: https://tmate.io/t/9bv76cP3W95ftZFbWtYtW4xJ7

[Notify] ssh session: ssh [email protected]

```

Web端访问终端可以在浏览器中打开`web session: `后面的URL。

SSH访问可以使用`ssh session: `后面的命令行。

## 在线调试Github Actions

创建以下workflow：`remote-ssh.yml`

```yml

name: Remote-SSH

on:

  watch:

    types: started

jobs:

  SSH:

    name: Run on ${{ matrix.os }}

    runs-on: ${{ matrix.os }}

    strategy:

      max-parallel: 4

      matrix:

        python-version: [3.6]

        os: [windows-latest, ubuntu-latest, macOS-latest]

    steps:

      - name: Set up Python ${{ matrix.python-version }}

        uses: actions/setup-python@v1

        with:

          python-version: ${{ matrix.python-version }}

      - name: Install dependencies

        run: |

          python -m pip install --upgrade pip

          python -m pip install -U tmate

      - name: SSH connection to Actions

        run: |

            python -m tmate

```

`Star`项目会自动触发该workflow。