🔐 SSHDC — SSH Controller

SSHDC is a clean, simple, and powerful open‑source tool for managing and accessing an SSH server running on Termux from a Windows machine.

🚀 Simple • 🔧 Powerful • 📱 friendly • 🧠 Human‑readable

---

📌 What is SSHDC?

SSHDC (SSH Controller) is a lightweight project that helps you:

• Run and manage an SSH server on Linux, Android (Termux)
• Connect to it easily from Windows
• Check server status, restart services, and test connectivity
• Avoid complex configuration and unnecessary tools

This project is designed to be:

• Beginner‑friendly
• Cleanly written
• Easy to debug
• Practical for real‑world use

---

🧠 How SSHDC Works

SSHDC follows a server–client model.

🖥️ Server (linux, Termux)

The server script (sshd-server.sh) runs on Termux and is responsible for:

• Starting and stopping the SSH daemon (sshd)
• Detecting the device IP address
• Saving network details into .ip.txt
• Checking SSH service and port status
• Restarting the SSH service safely

💻 Client (Windows)

The client script (sshd-client.ps1) runs on Windows and allows you to:

• Test whether the SSH server is reachable
• Verify the SSH port is open
• Connect to the server using standard SSH

All communication happens inside your local network, making it fast and secure.

---

✨ Features

🖥️ Server Features (linux, Termux)

• ▶️ Start SSH server (-l, --local)
• 🛑 Stop SSH server (-s, --stop)
• 🔄 Restart SSH server (-re, --restart)
• 📊 Check SSH status (-c, --check)
• 🧪 Test server info (-t, --test)
• 🌐 Automatic IP detection using ifconfig
• 🧾 Save IP details to .ip.txt
• 🔢 Custom SSH port support
• 📜 Optional logging
• 🧠 Clean and readable output

💻 Client Features (Windows)

• 🔍 Test SSH connectivity (--test)
• 🔗 Connect to SSH server (--local)
• 🔢 Custom port support
• 📘 Built‑in help and examples
• 🧠 Safe and reliable PowerShell logic

---

📋 Prerequisites

installating (linux, Termux)

• Termux installed
• Required packages:

  pkg install openssh net-tools

🖥️ Windows

• Windows 10 or 11
• OpenSSH Client enabled
• PowerShell 5.1 or later

---

📂 Project Structure

SSHDC/
├── sshd-server.sh        # Linux SSH server controller
├── sshd-client.ps1       # Windows PowerShell SSH client
├── README.md             # Documentation
├── LICENSE               # MIT License
└── .github/
    └── logo.png          # Project logo

---

⚙️ Installation

1️⃣ Clone the Repository

git clone https://github.com/rkstudio585/SSHDC.git
cd SSHDC

---

🚀 Using the Server (Linux, Termux)

• Make the script executable
• chmod +x sshd-server.sh
• Start SSH server

  ./sshd-server.sh --local

• Start with a custom port

  ./sshd-server.sh --local -p 7788

---

• Check SSH status

  ./sshd-server.sh --check

• Stop SSH server

  ./sshd-server.sh --stop

• Restart SSH server

  ./sshd-server.sh --restart -p 7788

---

🔑 Using the Client (Windows)

Test connection (recommended)

.\sshd-client.ps1 --test u0_a369@192.168.0.102 -p 7788

This checks:

• Host reachability
• Open port
• SSH service availability
• Connect to the server

  .\sshd-client.ps1 --local u0_a369@192.168.0.102 -p 7788

You will be prompted for your SSH password.

---

🧪 Example Workflow

1. Start SSH server on Termux
2. Run --check to verify status
3. Use --test from Windows
4. Connect using --local

• ✔ Simple
• ✔ Predictable
• ✔ Reliable

---

🛡️ Security Recommendations

• 🔐 Use SSH key authentication
• 🔢 Avoid default ports
• 🚫 Do not expose SSH publicly
• 🧪 Always test before connecting
• 📱 If use Termux Consider Termux:Boot for auto‑start

---

🤝 Contributing

Contributions are always welcome 💙

• You can:
  • Report bugs
  • Suggest new features
  • Improve documentation
  • Submit pull requests

Every contribution helps make SSHDC better 🙌

---

📄 License

This project is distributed under the MIT License.

• You are free to:
  • Use
  • Modify
  • Share
  • Distribute

With proper credit ❤️

---

🌟 Project Links

🔗 GitHub Repository

👉 https://github.com/rkstudio585/SSHDC

---

😊 Final Note

SSHDC was built with simplicity and clarity in mind. If this project helps you, consider giving it a ⭐ on GitHub.

Happy hacking 🚀🔐