Code Monkey home page Code Monkey logo

linux-remote's Introduction

linux-remote

A Webside Remote Desktop of Linux.

Requested

  • Linux.
  • Node.js 8+. and ensure all users are available.

Browsers Compatibility

Latest Chrome And Latest Firefox work fine.

Not IE.

Edge and Safari unknown(it should be OK).

Online Demo

First register a new user: https://register.linux-remote.org

Then visit demo: https://demo.linux-remote.org

Install

Step 1:

cd /opt/ && sudo git clone --depth 1 https://github.com/linux-remote/linux-remote.git && cd linux-remote

or:
cd /opt/ && sudo wget https://github.com/linux-remote/linux-remote/archive/master.zip -O "linux-remote.zip" && sudo unzip -q linux-remote.zip && sudo mv linux-remote-master linux-remote && sudo rm linux-remote.zip && cd linux-remote

/opt dir only writable for root. so you should use: sudo

Step 2: npm install

Step 3: sudo node init

It will generate config.js, and set permission: Only root users can read it.

Setting

modify ./config.js:

module.exports = {
  port: 3001, // Website listen port. default: 3001

  sshPort: 22, // SSH server listen port, default: 22

  ssl : null, // http model, Unsafe,  default: null.
  /*
  ssl: {  // Or provide an Object {cert, key} to enter https model: 
    cert: '/somedir/cert.pem',
    key: '/somedir/privkey.pem'
  },
  */
  
  sessionSecret: 'some 32 bytes string' // Use for express-session. generated by init.
};

For more please visit: Advanced setting

Start

sudo node index.js

Because server use login shell, and the login shell cannot possibly work without effective root. So linux-remote Can't cannot possibly work without effective root too.

Update

cd /opt/linux-remote && npm update

  • linux-remote-client Updated, you don't need restart server. Just need refresh browser.
  • @linux-remote/user-server Updated, you don't need restart server. Logined user need relogin.
  • linux-remote-server Updated, you need restart server. All logined user force logout when you restart server.

Secure

Configured with SSL certificate, your connection ( https and wss ) is secure. And you don't need verifying the Host Key first time like SSH.

If you don't have an SSL certificate, You can use ssl-self-signed to generate a new one ( supports IP ).

Donate

patreon: Du Wei is creating linux-remote

Paypal AliPay WechatPay

linux-remote's People

Contributors

hezedu avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.