KoKo

English · 简体中文

KoKo is a connector of JumpServer for secure connections using character protocols, supporting SSH, Telnet, Kubernetes, SFTP and database protocols

Koko is implemented using Golang and Vue, and the name comes from a Dota hero Kunkka。

Features

• SSH
• SFTP
• Web Terminal
• Web File Management

Installation

1. Clone the project

git clone https://github.com/jumpserver/koko.git

2. Build the application

Build the application in the koko project.

make

If the build is successful, the build folder will be automatically generated under the project, which contains compressed packages of various architectures of the current branch.

Usage (for Linux amd64 server)

1. Copy the compressed package file to the corresponding server

Build the default compressed package through make, the file name is as follows:
koko-[branch name]-[commit]-linux-amd64.tar.gz

2. Unzip the compiled compressed package

tar xzvf koko-[branch name]-[commit]-linux-amd64.tar.gz

3. Create the file config.yml, refer to config_example.yml

touch config.yml

4. run koko

cd koko-[branch name]-[commit]-linux-amd64

./koko

Setup development environment

1. Run the backend server

$ cp config_example.yml config.yml # 1. Prepare the configuration file
$ vim config.yml  # 2. Modify the configuration file, edit the address and bootstrap key
CORE_HOST: http://127.0.0.1:8080
BOOTSTRAP_TOKEN: PleaseChangeMe <change to the same as core>

$ go run ./cmd/koko/ # 3. Run, running requires go if not, download and install from go.dev

2. Run the ui frontend

$ cd ui 
$ yarn install
$ npm run serve

Docker

To build multi-platform images using Docker Buildx, you need to install Docker version 19.03 or higher and enable the Docker Buildx plugin.

make docker