Skip to content

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

License

Notifications You must be signed in to change notification settings

jumpserver/koko

Repository files navigation

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
  1. 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
  1. Unzip the compiled compressed package
tar xzvf koko-[branch name]-[commit]-linux-amd64.tar.gz
  1. Create the file config.yml, refer to config_example.yml
touch config.yml
  1. 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
  1. 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