Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/TNK-Studio/gortal

🚪A super lightweight jumpserver service developed using the Go language. 一个使用 Go 语言开发的，超级轻量的跳板机服务。
https://github.com/TNK-Studio/gortal

golang jumpserver jumpserver-service lightweight tools

Last synced: 1 day ago
JSON representation

🚪A super lightweight jumpserver service developed using the Go language. 一个使用 Go 语言开发的，超级轻量的跳板机服务。

Host: GitHub
URL: https://github.com/TNK-Studio/gortal
Owner: TNK-Studio
License: apache-2.0
Created: 2019-11-27T03:52:59.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2020-11-17T02:28:31.000Z (almost 4 years ago)
Last Synced: 2024-08-02T06:19:20.508Z (3 months ago)
Topics: golang, jumpserver, jumpserver-service, lightweight, tools
Language: Go
Homepage:
Size: 277 KB
Stars: 360
Watchers: 7
Forks: 59
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

my-awesome - TNK-Studio/gortal - service,lightweight,tools pushed_at:2020-11 star:0.4k fork:0.1k 🚪A super lightweight jumpserver service developed using the Go language. 一个使用 Go 语言开发的，超级轻量的跳板机服务。 (Go)
awesome-ops - TNK-Studio/gortal - 2.0|362|2019-11-27|2020-11-17 | 一个使用 Go 语言开发的，超级轻量的跳板机服务。 | (堡垒机)
awesome-hacking-lists - TNK-Studio/gortal - 🚪A super lightweight jumpserver service developed using the Go language. 一个使用 Go 语言开发的，超级轻量的跳板机服务。 (Go)

README

# gortal

[![Actions Status](https://img.shields.io/github/workflow/status/TNK-Studio/gortal/Build%20release)](https://github.com/TNK-Studio/gortal/actions)[![Docker build](https://img.shields.io/docker/cloud/build/elfgzp/gortal)](https://hub.docker.com/repository/docker/elfgzp/gortal)[![Docker build automated](https://img.shields.io/docker/cloud/automated/elfgzp/gortal)](https://hub.docker.com/repository/docker/elfgzp/gortal)
[![Docker pull](https://img.shields.io/docker/pulls/elfgzp/gortal)](https://hub.docker.com/repository/docker/elfgzp/gortal)[![Release Download](https://img.shields.io/github/downloads/TNK-Studio/gortal/total)](https://github.com/TNK-Studio/gortal/releases)

A super lightweight jumpserver service developed using the Go language. [English Document](./README.md) | [中文文档](./doc/README_CN.md)

![gortal](./doc/gortal.gif)

## Deployment

Gortal needs a server with a public IP as the server for the jumpserver service.
This server needs external network access to be able to access the target server you need to access.

### Docker

```shell
$ docker pull elfgzp/gortal:latest
$ mkdir -p ~/.gortal/.ssh
$ docker run \
-p 2222:2222 \
-v ~/.gortal:/root\
-v ~/.gortal/.ssh:/root/.ssh\
--name gortal -d gortal:latest
```

### Binary file

Download the version you need from the [Release](https://github.com/TNK-Studio/gortal/releases) page, decompress it to get the `gortal` binary executable, and run it.

```shell
$ ./gortal
starting ssh server on port 2222...
```

## How to use

### First Time

After the gortal service is started, an sshd service will be started on port `2222`. You can also set the startup port through `-p`.

After the service is started, you only need to use the `ssh` command to access the service.

```shell
$ ssh 127.0.0.1 -p 2222
[email protected]'s password:
New Username: root█
Password: ******█
Confirm your password: ******█
Please login again with your new acount.
Shared connection to 127.0.0.1 closed.
```

The default user password for the first access is `newuser`, and then the command line prompts to create a new user. Follow the prompts to create a new `admin` account for the jumpserver service.

```shell
$ ssh [email protected] -p 2222
[email protected]'s password:
Use the arrow keys to navigate: ↓ ↑ → ←
? Please select the function you need:
▸ List servers
Edit users
Edit servers
Edit personal info
Quit
```

You can use it after logging in with your password again.

### Upload or download file server via jumpserver

If you want to upload or download file from the server via jumpserver, you can use the `scp` command in the following format:

```shell
$ scp -P 2222 ~/Desktop/README.md gzp@jumpserver:gzp@server2:~/Desktop/README1.md
README.md 100% 9279 73.9KB/s 00:00
```

```shell
scp -P 2222 gzp@jumpserver:gzp@server2:~/Desktop/video.mp4 ~/Downloads
video.mp4 100% 10MB 58.8MB/s 00:00
```

Note the use of `:` after `gzp@jumpserver` plus the `key` and `username` of the server you need to transfer, and finally write the destination or source path.
Folder transfer is currently not supported. Please compress the file and upload or download it.