Go to file

Karmaa 7ddcb42f7f Feature engineering improvements (#376 )

* chore: add engineering improvements

- Configure Prettier with unified code style rules
- Add husky + lint-staged for automated pre-commit checks
- Add commitlint to enforce conventional commit messages
- Add PR check workflow for CI automation
- Auto-format all files with Prettier
- Fix TypeScript any types in field-crypto.ts

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* chore: enhance development environment

- Add .editorconfig for unified editor settings
- Add .nvmrc to specify Node.js version (20)
- Add useful npm scripts: format, format:check, lint, lint:fix, type-check

* chore: add IDE and Git configuration

- Add VS Code workspace settings for consistent development experience
- Add VS Code extension recommendations (ESLint, Prettier, EditorConfig)
- Add .gitattributes to enforce LF line endings

* refactor: clean up unused variables and empty blocks

- database.ts: Remove unused variables (authManager, format, HTTPS_PORT, etc.)
- database.ts: Fix empty catch blocks with descriptive comments
- database.ts: Add eslint-disable for required middleware parameter
- db/index.ts: Remove unused variables and fix empty catch blocks
- Temporarily remove ESLint from pre-commit to allow incremental fixes

Reduced total errors from 947 to 913 (34 fixes)

* refactor: clean up unused variables and empty blocks in routes

Routes updated:
- credentials.ts: Remove 12 unused variables/imports
- alerts.ts: Remove 1 unused variable
- users.ts: Remove 9 unused variables/imports

Changes:
- Remove unused imports (NextFunction, jwt, UserCrypto, detectKeyType)
- Fix empty catch blocks with descriptive comments
- Prefix reserved parameters with underscore
- Clean up unused error variables in catch blocks

Reduced errors from 913 to 886 (27 fixes)

* refactor: clean up unused variables in routes/ssh.ts

- Remove unused imports (NextFunction, jwt)
- Remove 6 unused variables (result, updateResult, name x3)
- All 8 no-unused-vars errors fixed

* refactor: clean up unused variables and empty blocks in file-manager.ts

- Remove 22 unused variables (linkCount, hostId, userId, content, escapedTempFile, index, code)
- Fix 1 empty catch block
- Simplify multiple route handlers by removing unused destructured parameters

Reduced errors from 878 to 855 (23 fixes)

* refactor: clean up unused variables and empty blocks in utils

database-migration.ts:
- Remove 3 unused variables (encryptedSize, totalOriginalRows, totalMemoryRows)

lazy-field-encryption.ts:
- Fix 6 empty catch blocks with descriptive comments
- Keep error variables where they are used in logging

tunnel.ts:
- Fix multiple empty catch blocks
- Remove empty else blocks
- Partially fixed (10/21 issues resolved)

Reduced errors from 855 to 833 (22 fixes)

* fix: restore error variable in catch block for logging

Fix TypeScript error where error variable was removed from catch block
but still used in logging statements. The error variable is needed for
proper error logging and re-throwing.

* fix: clean up tunnel.ts empty blocks and unused variables

移除了 tunnel.ts 中的空块和未使用的变量：
- 移除 2 个空 else 块
- 修复 2 个空 if 块并添加注释
- 修复空错误处理器并添加注释
- 将未使用的 err 参数重命名为 _err

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: clean up empty blocks and unused variables in backend utils

修复了后端工具文件中的空块和未使用的变量：
- auth-manager.ts: 移除空 else 块
- system-crypto.ts: 修复空 catch 块并添加注释
- starter.ts: 修复空 catch 块并添加注释
- server-stats.ts: 将未使用的 reject 参数重命名为 _reject
- credentials.ts: 将 connectionTimeout 从 let 改为 const

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: clean up empty catch blocks in frontend components

修复了前端组件中的空 catch 块：
- Tunnel.tsx: 修复空 catch 块并添加注释
- ServerConfig.tsx: 修复空 catch 块并添加注释
- TerminalKeyboard.tsx: 修复空 catch 块并添加注释
- system-crypto.ts: 修复遗漏的空 catch 块

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: clean up empty catch blocks in backend utilities

修复了后端工具文件中的 10 个空 catch 块：
- system-crypto.ts: 修复 1 个空 catch 块
- server-stats.ts: 修复 4 个空 catch 块
- auto-ssl-setup.ts: 修复 1 个空 catch 块
- ssh-key-utils.ts: 修复 4 个空 catch 块

所有空块都添加了描述性注释说明为何忽略错误。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: clean up empty catch blocks in UI hooks and components

修复了 5 个 UI 组件和 hooks 中的空 catch 块：
- useDragToSystemDesktop.ts: 修复 2 个空 catch 块
- HomepageAuth.tsx: 修复 1 个空 catch 块
- HostManagerEditor.tsx: 修复 2 个空 catch 块

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: clean up empty blocks in file manager and credential editor

修复了 5 个空块：
- FileManagerGrid.tsx: 移除 1 个空 else 块和 1 个空 if 块
- CredentialEditor.tsx: 修复 1 个空 catch 块，移除 2 个空 if/else 块

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: clean up all empty catch blocks in Terminal components

修复了 Terminal 组件中的所有 8 个空 catch 块：
- Desktop/Apps/Terminal/Terminal.tsx: 修复 5 个空 catch 块
- Mobile/Apps/Terminal/Terminal.tsx: 修复 3 个空 catch 块

所有空块都添加了描述性注释。这是空块修复的最后一批。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: remove useless try/catch wrappers

移除了 3 个无用的 try/catch 包装器：
- users.ts: 移除只重新抛出错误的外层 try/catch
- FileManager.tsx: 移除只重新抛出错误的内层 try/catch
- DiffViewer.tsx: 移除只重新抛出错误的内层 try/catch

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: remove unused imports and mark unused parameters

移除了未使用的导入和标记未使用的参数：
- auto-ssl-setup.ts: 移除未使用的 crypto 导入
- user-crypto.ts: 移除未使用的 users 导入
- user-data-import.ts: 移除未使用的 nanoid 导入
- simple-db-ops.ts: 标记未使用的 userId 和 tableName 参数

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: remove unnecessary escape characters in regex patterns

移除了正则表达式中不必要的转义字符：
- users.ts: 修复 5 个 \/ 不必要的转义
- TabContext.tsx: 修复 1 个 \/ 不必要的转义

在字符串形式的正则表达式中，/ 不需要转义。

---------

Co-authored-by: ZacharyZcR <zacharyzcr1984@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>

2025-10-07 20:06:01 -05:00

.github

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.husky

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.vscode

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

docker

Add real client IP

2025-10-05 23:51:53 -05:00

electron

v.1.7.1 (#335 )

2025-10-03 00:02:10 -05:00

public

Finalize font update

2025-10-06 21:11:38 -05:00

repo-images

Feature/german language support (#374 )

2025-10-07 15:32:31 -05:00

scripts

v1.7.0 (#318 )

2025-10-01 15:40:10 -05:00

src

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.commitlintrc.json

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.dockerignore

v1.7.0 (#318 )

2025-10-01 15:40:10 -05:00

.editorconfig

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.gitattributes

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.gitignore

v1.7.0 (#318 )

2025-10-01 15:40:10 -05:00

.nvmrc

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.prettierignore

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

.prettierrc

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

CODE_OF_CONDUCT.md

v.1.7.1 (#335 )

2025-10-03 00:02:10 -05:00

components.json

v1.6.0 (#221 )

2025-09-12 14:42:00 -05:00

CONTRIBUTING.md

v1.7.0 (#318 )

2025-10-01 15:40:10 -05:00

electron-builder.json

v.1.7.1 (#335 )

2025-10-03 00:02:10 -05:00

eslint.config.js

v1.6.0 (#221 )

2025-09-12 14:42:00 -05:00

index.html

Clean commit without large files

2025-08-07 02:20:27 -05:00

LICENSE

Clean commit without large files

2025-08-07 02:20:27 -05:00

openapi.json

v1.6.0 (#221 )

2025-09-12 14:42:00 -05:00

package-lock.json

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

package.json

Feature engineering improvements (#376 )

2025-10-07 20:06:01 -05:00

README-CN.md

Update read me

2025-09-12 15:18:07 -05:00

README.md

Feature/german language support (#374 )

2025-10-07 15:32:31 -05:00

SECURITY.md

Update SECURITY.md to streamline vulnerability reporting

2025-10-01 11:00:13 -05:00

tsconfig.app.json

v1.6.0 (#221 )

2025-09-12 14:42:00 -05:00

tsconfig.json

v1.6.0 (#221 )

2025-09-12 14:42:00 -05:00

tsconfig.node.json

v1.6.0 (#221 )

2025-09-12 14:42:00 -05:00

vite.config.ts

v1.7.0 (#318 )

2025-10-01 15:40:10 -05:00

README.md

Repo Stats

English | 中文

Achieved on September 1st, 2025

Top Technologies

If you would like, you can support the project here!

Overview

Termix is an open-source, forever-free, self-hosted all-in-one server management platform. It provides a web-based solution for managing your servers and infrastructure through a single, intuitive interface. Termix offers SSH terminal access, SSH tunneling capabilities, and remote file management, with many more tools to come.

Features

SSH Terminal Access - Full-featured terminal with split-screen support (up to 4 panels) and tab system
SSH Tunnel Management - Create and manage SSH tunnels with automatic reconnection and health monitoring
Remote File Manager - Manage files directly on remote servers with support for viewing and editing code, images, audio, and video. Upload, download, rename, delete, and move files seamlessly.
SSH Host Manager - Save, organize, and manage your SSH connections with tags and folders, and easily save reusable login info while being able to automate the deployment of SSH keys
Server Stats - View CPU, memory, and HDD usage on any SSH server
User Authentication - Secure user management with admin controls and OIDC and 2FA (TOTP) support
Database Encryption - SQLite database files encrypted at rest with automatic encryption/decryption
Data Export/Import - Export and import SSH hosts, credentials, and file manager data with incremental sync
Automatic SSL Setup - Built-in SSL certificate generation and management with HTTPS redirects
Modern UI - Clean desktop/mobile-friendly interface built with React, Tailwind CSS, and Shadcn
Languages - Built-in support for English and Chinese
Platform Support - Available as a web app, desktop application (Windows & Linux), and dedicated mobile app for iOS and Android. macOS and iPadOS support is planned.

Planned Features

See Projects for all planned features. If you are looking to contribute, see Contributing.

Installation

Supported Devices:

Website (any modern browser like Google, Safari, and Firefox)
Windows (app)
Linux (app)
iOS (app)
Android (app)
iPadOS and macOS are in progress

Visit the Termix Docs for more information on how to install Termix on all platforms. Otherwise, view a sample Docker Compose file here:

services:
  termix:
    image: ghcr.io/lukegus/termix:latest
    container_name: termix
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - termix-data:/app/data
    environment:
      PORT: "8080"

volumes:
  termix-data:
    driver: local

Support

If you need help with Termix, you can join the Discord server and visit the support channel. You can also open an issue or open a pull request on the GitHub repo.