deadRabbit/mRemotify
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

new Readme

Browse Source
This commit is contained in:
felixg
2026-03-01 12:06:22 +01:00
parent 93bf9ab70d
commit 4f5eb3a49c
1 changed files with 29 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
README.md
View File

@@ -1,8 +1,8 @@
# mRemotify # mRemotify
A browser-based remote connection manager — open-source alternative to mRemoteNG. Browser-based remote connection manager — open-source alternative to mRemoteNG.
Manage SSH and RDP connections through a clean web UI with a familiar tree-based layout and tabbed session view. Manage SSH and RDP connections through a web UI with a tree-based layout, tabbed sessions, and connection profiles.
## Stack ## Stack
@@ -11,82 +11,74 @@ Manage SSH and RDP connections through a clean web UI with a familiar tree-based
| Frontend | React 18 · TypeScript · Vite · Ant Design 5 | | Frontend | React 18 · TypeScript · Vite · Ant Design 5 |
| Backend | Fastify · TypeScript · Prisma · PostgreSQL | | Backend | Fastify · TypeScript · Prisma · PostgreSQL |
| SSH | ssh2 (Node.js) proxied over WebSocket | | SSH | ssh2 (Node.js) proxied over WebSocket |
| RDP | Apache Guacamole (guacd) + guacamole-common-js | | RDP | rdpd (Rust) — Xvfb + xfreerdp3 + x11rb |
| Auth | JWT · bcryptjs · AES-256 password encryption | | Auth | JWT · bcryptjs · AES-256 encryption at rest |
| Infra | Docker Compose · pnpm workspaces | | Infra | Docker Compose · pnpm workspaces |
## Features ## Features
- **Connection tree** — folders with drag-and-drop, Linux / Windows icons per connection - **Connection tree** — folders with drag-and-drop, context menus, search
- **Tabbed sessions** — each opened connection gets its own tab - **Tabbed sessions** — each connection opens in its own tab
- **SSH sessions** — full xterm.js terminal over WebSocket - **SSH terminal** — xterm.js over WebSocket, resize support
- **RDP sessions** — Guacamole-based remote desktop in the browser - **RDP viewer** — canvas-based remote desktop via rdpd (JPEG frame streaming)
- **Encrypted storage** — passwords stored AES-256 encrypted at rest - **Connection profiles** — reusable credential templates (SSH or RDP specific), assigned per connection. Profile values act as defaults, connection-level values override.
- **JWT auth** — login-protected, all API + WebSocket routes secured - **Encrypted storage** — passwords and private keys AES-256 encrypted at rest
- **JWT auth** — all API and WebSocket routes are login-protected
## Quick start (Docker Compose) ## Quick start (Docker Compose)
```bash ```bash
# 1. Clone & enter
git clone https://github.com/yourname/mremotify.git git clone https://github.com/yourname/mremotify.git
cd mremotify cd mremotify
# 2. Configure environment
cp .env.example .env cp .env.example .env
# Edit .env: set ENCRYPTION_KEY (32 chars), JWT_SECRET, ADMIN_PASSWORD # Edit .env: set ENCRYPTION_KEY, JWT_SECRET, ADMIN_PASSWORD
# 3. Start everything
docker compose up -d docker compose up -d
# 4. Open in browser
open http://localhost open http://localhost
``` ```
Default login: `admin` / `admin123` (change via `ADMIN_USER` / `ADMIN_PASSWORD` in `.env` before first start). Default login: `admin` / `admin123` (set `ADMIN_USER` / `ADMIN_PASSWORD` in `.env` before first start).
## Development (without Docker) ## Development
Prerequisites: Node.js >= 20, pnpm >= 9, PostgreSQL running locally. Prerequisites: Node.js >= 20, pnpm >= 9, PostgreSQL running locally.
```bash ```bash
# Install all workspace dependencies
pnpm install pnpm install
# Copy and fill in env
cp .env.example .env cp .env.example .env
# Set POSTGRES_URL to your local DB, etc. # Set POSTGRES_URL to your local DB
# Run DB migrations + seed
cd backend && npx prisma migrate dev && npx prisma db seed && cd .. cd backend && npx prisma migrate dev && npx prisma db seed && cd ..
# Start backend + frontend in parallel
pnpm dev pnpm dev
``` ```
Frontend dev server: http://localhost:5173 Frontend dev server runs on http://localhost:5173 (proxies `/api` and `/ws` to backend).
Backend API: http://localhost:3000 Backend API runs on http://localhost:3000.
## Project structure ## Project structure
``` ```
mremotify/ mremotify/
frontend/ React + Vite app frontend/ React + Vite SPA
backend/ Fastify API + WebSocket proxies backend/ Fastify API, WebSocket proxies, Prisma schema
rdpd/ Rust RDP daemon (Xvfb + xfreerdp3, WebSocket on :7777)
docker/ Dockerfiles + nginx config docker/ Dockerfiles + nginx config
docker-compose.yml docker-compose.yml
.env.example .env.example
pnpm-workspace.yaml
``` ```
## Environment variables ## Environment variables
| Variable | Description | | Variable | Description |
|-------------------|-----------------------------------------------| |-------------------|----------------------------------------------|
| POSTGRES_URL | PostgreSQL connection string | | POSTGRES_URL | PostgreSQL connection string |
| ENCRYPTION_KEY | 32-character key for AES-256 password crypto | | ENCRYPTION_KEY | Key for AES-256 encryption (passwords, keys) |
| JWT_SECRET | Secret for signing JWT tokens | | JWT_SECRET | Secret for signing JWT tokens |
| ADMIN_USER | Initial admin username | | ADMIN_USER | Initial admin username |
| ADMIN_PASSWORD | Initial admin password | | ADMIN_PASSWORD | Initial admin password |
| GUACD_HOST | Hostname of guacd service | | RDPD_URL | rdpd WebSocket URL (default: ws://rdpd:7777) |
| GUACD_PORT | Port of guacd service (default: 4822) |
| PORT | Backend port (default: 3000) | | PORT | Backend port (default: 3000) |