Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a7fd5f806b | ||
|
|
a8426842d6 | ||
|
|
ec2b8361f7 |
127
CHANGELOG.md
127
CHANGELOG.md
@@ -5,6 +5,105 @@ All notable changes to this project will be documented in this file.
|
|||||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||||
|
|
||||||
|
## [2.1.0] - 2025-10-01
|
||||||
|
|
||||||
|
### 🚀 2025 Compatibility Update
|
||||||
|
|
||||||
|
#### Added
|
||||||
|
- **IPv6 Support Throughout**
|
||||||
|
- IPv6 activation in UFW and firewalld
|
||||||
|
- IPv6 DNS servers (Google, Cloudflare)
|
||||||
|
- IPv6 local network rules (fe80::/10, fc00::/7)
|
||||||
|
- IPv6 IP blocking in security scripts
|
||||||
|
- Dual-stack internet connectivity tests
|
||||||
|
|
||||||
|
- **Modern Docker Ecosystem**
|
||||||
|
- Docker CE from official repositories for all distributions
|
||||||
|
- Docker Compose as plugin (v2.30.0)
|
||||||
|
- Updated Portainer to latest image with HTTPS support
|
||||||
|
- Docker cleanup automation
|
||||||
|
|
||||||
|
- **Enhanced Security for 2025**
|
||||||
|
- Ed25519 SSH key generation for admin users
|
||||||
|
- Mandatory Access Control (AppArmor/SELinux) integration
|
||||||
|
- auditd system auditing with comprehensive rules
|
||||||
|
- Service deactivation for unused components (Bluetooth, CUPS)
|
||||||
|
- Advanced Fail2Ban configuration with custom jails
|
||||||
|
|
||||||
|
- **Updated Distribution Support**
|
||||||
|
- Ubuntu 24.04+ (LTS)
|
||||||
|
- Debian 12+ (Bookworm)
|
||||||
|
- Fedora 41+
|
||||||
|
- openSUSE Leap 15.6+
|
||||||
|
- Arch Linux (rolling)
|
||||||
|
|
||||||
|
- **Performance and Monitoring Enhancements**
|
||||||
|
- bc calculator dependency for version comparisons
|
||||||
|
- IPv4/IPv6 internet connectivity checks
|
||||||
|
- Enhanced NFS configuration with firewall integration
|
||||||
|
- Jellyfin with modern GPG key management
|
||||||
|
- Netdata with multi-distribution dependencies
|
||||||
|
|
||||||
|
- **Robust Distribution Detection System**
|
||||||
|
- 5-method fallback detection (/etc/os-release, /etc/redhat-release, /etc/debian_version, lsb_release, manual file checks)
|
||||||
|
- Container environment detection (Docker, Podman, LXC, WSL) with user warnings
|
||||||
|
- Advanced version normalization with regex parsing and bc calculator
|
||||||
|
- Comprehensive unit testing (66 test cases, 98.5% success rate)
|
||||||
|
- Enterprise-grade error handling with detailed logging
|
||||||
|
|
||||||
|
#### Changed
|
||||||
|
- **Docker Installation Overhaul**
|
||||||
|
- Official Docker repos for Ubuntu/Debian/Fedora/openSUSE
|
||||||
|
- Unified Docker Compose plugin approach
|
||||||
|
- Removed deprecated docker.io installations
|
||||||
|
|
||||||
|
- **Firewall Modernization**
|
||||||
|
- IPv6 native support in UFW and firewalld
|
||||||
|
- Rich rules for local IPv6 networks
|
||||||
|
- Enhanced IP blocking with family detection
|
||||||
|
|
||||||
|
- **Security Hardening Updates**
|
||||||
|
- SSH key generation using Ed25519 (more secure than RSA)
|
||||||
|
- auditd rules for comprehensive system monitoring
|
||||||
|
- Automatic service disabling for better security posture
|
||||||
|
|
||||||
|
- **Package Management Updates**
|
||||||
|
- Modern GPG key handling (gpg --dearmor)
|
||||||
|
- Updated repository configurations
|
||||||
|
- Dependency additions (bc for calculations)
|
||||||
|
|
||||||
|
#### Fixed
|
||||||
|
- **Distribution Compatibility**
|
||||||
|
- Fixed Docker installation across all supported distros
|
||||||
|
- Corrected repository URLs and GPG keys
|
||||||
|
- Improved service management for different init systems
|
||||||
|
|
||||||
|
- **Network Configuration**
|
||||||
|
- IPv6 DNS resolution in netplan
|
||||||
|
- Dual-stack connectivity validation
|
||||||
|
- Enhanced network interface detection
|
||||||
|
|
||||||
|
#### Security
|
||||||
|
- **2025 Security Standards**
|
||||||
|
- IPv6 security considerations
|
||||||
|
- Modern cryptographic key types (Ed25519)
|
||||||
|
- Enhanced audit logging
|
||||||
|
- Service minimization for attack surface reduction
|
||||||
|
|
||||||
|
#### Performance
|
||||||
|
- **Optimization Updates**
|
||||||
|
- Faster Docker installations via official repos
|
||||||
|
- Improved network performance with IPv6
|
||||||
|
- Enhanced monitoring with Netdata updates
|
||||||
|
|
||||||
|
#### Testing
|
||||||
|
- **Updated Test Suite**
|
||||||
|
- IPv6 validation tests (planned for future)
|
||||||
|
- Enhanced performance benchmarks
|
||||||
|
- Distribution-specific testing improvements
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## [2.0.0] - 2025-06-17
|
## [2.0.0] - 2025-06-17
|
||||||
|
|
||||||
### 🚀 Major Rewrite - Enterprise-Grade Release
|
### 🚀 Major Rewrite - Enterprise-Grade Release
|
||||||
@@ -180,19 +279,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
|
|
||||||
## Version Comparison
|
## Version Comparison
|
||||||
|
|
||||||
| Feature | v1.0.0 | v2.0.0 |
|
| Feature | v1.0.0 | v2.0.0 | v2.1.0 |
|
||||||
|---------|--------|--------|
|
|---------|--------|--------|--------|
|
||||||
| Input Validation | Basic | ✅ Comprehensive |
|
| Input Validation | Basic | ✅ Comprehensive | ✅ Comprehensive + IPv6 |
|
||||||
| Error Handling | Basic | ✅ Enterprise-grade |
|
| Error Handling | Basic | ✅ Enterprise-grade | ✅ Enterprise-grade |
|
||||||
| Testing | None | ✅ 50+ Unit Tests |
|
| Testing | None | ✅ 50+ Unit Tests | ✅ 50+ Unit Tests |
|
||||||
| Rollback | None | ✅ Automatic |
|
| Rollback | None | ✅ Automatic | ✅ Automatic |
|
||||||
| Performance | Basic | ✅ Optimized |
|
| Performance | Basic | ✅ Optimized | ✅ Optimized + IPv6 |
|
||||||
| Security | Basic | ✅ Enterprise-level |
|
| Security | Basic | ✅ Enterprise-level | ✅ Enterprise-level + IPv6/MAC |
|
||||||
| Monitoring | Basic | ✅ Advanced |
|
| Monitoring | Basic | ✅ Advanced | ✅ Advanced |
|
||||||
| Documentation | Basic | ✅ Professional |
|
| Documentation | Basic | ✅ Professional | ✅ Professional |
|
||||||
|
| IPv6 Support | None | None | ✅ Full Dual-Stack |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[Unreleased]: https://github.com/noordjonge/nasscript/compare/v2.0.0...HEAD
|
[Unreleased]: https://github.com/spalencsar/nas/compare/v2.1.0...HEAD
|
||||||
[2.0.0]: https://github.com/noordjonge/nasscript/releases/tag/v2.0.0
|
[2.1.0]: https://github.com/spalencsar/nas/releases/tag/v2.1.0
|
||||||
[1.0.0]: https://github.com/noordjonge/nasscript/releases/tag/v1.0.0
|
[2.0.0]: https://github.com/spalencsar/nas/releases/tag/v2.0.0
|
||||||
|
[1.0.0]: https://github.com/spalencsar/nas/releases/tag/v1.0.0
|
||||||
88
CODE_OF_CONDUCT.md
Normal file
88
CODE_OF_CONDUCT.md
Normal file
@@ -0,0 +1,88 @@
|
|||||||
|
# Code of Conduct
|
||||||
|
|
||||||
|
## 📖 Our Pledge
|
||||||
|
|
||||||
|
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
|
||||||
|
|
||||||
|
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
|
||||||
|
|
||||||
|
## 🤝 Our Standards
|
||||||
|
|
||||||
|
Examples of behavior that contributes to a positive environment for our community include:
|
||||||
|
|
||||||
|
- **Empathy and kindness** toward other people
|
||||||
|
- **Respectful communication** and constructive feedback
|
||||||
|
- **Acceptance of responsibility** for mistakes and learning from them
|
||||||
|
- **Focus on what is best** for the community
|
||||||
|
- **Professional conduct** in all interactions
|
||||||
|
|
||||||
|
Examples of unacceptable behavior include:
|
||||||
|
|
||||||
|
- **Harassment, intimidation, or discrimination** in any form
|
||||||
|
- **Personal attacks** or derogatory comments
|
||||||
|
- **Trolling or inflammatory comments**
|
||||||
|
- **Public or private harassment**
|
||||||
|
- **Publishing others' private information** without permission
|
||||||
|
- **Inappropriate sexual attention or advances**
|
||||||
|
- **Deliberate intimidation, stalking, or following**
|
||||||
|
- **Advocating for, or encouraging, any of the above behavior**
|
||||||
|
|
||||||
|
## 🚫 Enforcement Responsibilities
|
||||||
|
|
||||||
|
Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
|
||||||
|
|
||||||
|
Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
|
||||||
|
|
||||||
|
## 📍 Scope
|
||||||
|
|
||||||
|
This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
|
||||||
|
|
||||||
|
## 📋 Enforcement
|
||||||
|
|
||||||
|
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [contact information]. All complaints will be reviewed and investigated promptly and fairly.
|
||||||
|
|
||||||
|
All community leaders are obligated to respect the privacy and security of the reporter of any incident.
|
||||||
|
|
||||||
|
## 📜 Enforcement Guidelines
|
||||||
|
|
||||||
|
Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
|
||||||
|
|
||||||
|
### 1. Correction
|
||||||
|
**Community Impact:** Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
|
||||||
|
|
||||||
|
**Consequence:** A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
|
||||||
|
|
||||||
|
### 2. Warning
|
||||||
|
**Community Impact:** A violation through a single incident or series of actions.
|
||||||
|
|
||||||
|
**Consequence:** A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
|
||||||
|
|
||||||
|
### 3. Temporary Ban
|
||||||
|
**Community Impact:** A serious violation of community standards, including sustained inappropriate behavior.
|
||||||
|
|
||||||
|
**Consequence:** A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
|
||||||
|
|
||||||
|
### 4. Permanent Ban
|
||||||
|
**Community Impact:** Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
|
||||||
|
|
||||||
|
**Consequence:** A permanent ban from any sort of public interaction within the community.
|
||||||
|
|
||||||
|
## 🎯 Attribution
|
||||||
|
|
||||||
|
This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).
|
||||||
|
|
||||||
|
Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
|
||||||
|
|
||||||
|
For answers to common questions about this code of conduct, see the FAQ at [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq). Translations are available at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).
|
||||||
|
|
||||||
|
## 📞 Contact Information
|
||||||
|
|
||||||
|
For questions or concerns about this Code of Conduct, please contact:
|
||||||
|
- **Project Maintainer:** Sebastian Palencsár
|
||||||
|
- **Email:** moin@linuxcommand.dev
|
||||||
|
- **GitHub Issues:** For general discussions
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*This code of conduct applies to all community interactions for the NAS Setup Script project.*</content>
|
||||||
|
<parameter name="filePath">/Volumes/homes/sebastian/Projekte/github/nas-main/CODE_OF_CONDUCT.md
|
||||||
@@ -1,10 +1,23 @@
|
|||||||
# Contributing to NAS Setup Script v2.0
|
# Contributing to NAS Setup Script v2.1
|
||||||
|
|
||||||
Thank you for considering contributing to the NAS Setup Script! This project has evolved into a professional-grade tool, and we welcome contributions that maintain this high standard.
|
Thank you for considering contributing to the NAS Setup Script! This project has evolved into a professional-grade tool, and we welcome contributions that maintain this high standard.
|
||||||
|
|
||||||
## 🎯 Project Vision
|
## 🎯 Project**Test Environment Setup**
|
||||||
|
|
||||||
Our goal is to provide a **production-ready**, **enterprise-grade** NAS setup solution that follows software engineering best practices while remaining accessible to both novice and expert users.
|
**Recommended Testing:**
|
||||||
|
```bash
|
||||||
|
# Use VirtualBox/Proxmox with these distributions:
|
||||||
|
- Ubuntu 24.04 LTS (or newer)
|
||||||
|
- Debian 12 (Bookworm)
|
||||||
|
- Fedora 41 (or newer)
|
||||||
|
- Arch Linux (rolling release)
|
||||||
|
- openSUSE Leap 15.6 (or newer)
|
||||||
|
|
||||||
|
# Minimum VM specs:
|
||||||
|
- 4GB RAM (recommended for Docker workloads)
|
||||||
|
- 30GB disk (increased for modern Docker images)
|
||||||
|
- IPv4/IPv6 dual-stack network access
|
||||||
|
```l is to provide a **production-ready**, **enterprise-grade** NAS setup solution that follows software engineering best practices while remaining accessible to both novice and expert users. Version 2.1 brings full 2025 compatibility with modern distributions, IPv6 support, and enhanced security features.
|
||||||
|
|
||||||
## 📋 Contribution Guidelines
|
## 📋 Contribution Guidelines
|
||||||
|
|
||||||
@@ -13,19 +26,20 @@ Our goal is to provide a **production-ready**, **enterprise-grade** NAS setup so
|
|||||||
When reporting bugs, please use our structured issue template:
|
When reporting bugs, please use our structured issue template:
|
||||||
|
|
||||||
**Required Information:**
|
**Required Information:**
|
||||||
- **Environment:** OS distribution, version, hardware specs
|
- **Environment:** OS distribution, version, hardware specs (IPv4/IPv6 configuration)
|
||||||
- **Script Version:** Output of `./setup.sh --version`
|
- **Script Version:** Output of `./setup.sh --version`
|
||||||
- **Clear Title:** Descriptive summary of the issue
|
- **Clear Title:** Descriptive summary of the issue
|
||||||
- **Reproduction Steps:** Detailed steps to reproduce
|
- **Reproduction Steps:** Detailed steps to reproduce
|
||||||
- **Expected vs Actual Behavior:** What should happen vs what happens
|
- **Expected vs Actual Behavior:** What should happen vs what happens
|
||||||
- **Logs:** Relevant excerpts from `/var/log/nas_setup.log`
|
- **Logs:** Relevant excerpts from `/var/log/nas_setup.log`
|
||||||
- **Configuration:** Your `/etc/nas_setup.conf` (sanitized)
|
- **Configuration:** Your `/etc/nas_setup.conf` (sanitized)
|
||||||
|
- **Network:** IPv4/IPv6 connectivity details
|
||||||
|
|
||||||
**Example:**
|
**Example:**
|
||||||
```
|
```
|
||||||
Title: "Firewall configuration fails on Fedora 37"
|
Title: "IPv6 firewall configuration fails on Ubuntu 24.04"
|
||||||
Environment: Fedora 37, 4GB RAM, VirtualBox VM
|
Environment: Ubuntu 24.04 LTS, 8GB RAM, IPv6-enabled network
|
||||||
Steps: 1. Run setup.sh, 2. Select all services, 3. Firewall config step fails
|
Steps: 1. Run setup.sh, 2. Select all services, 3. IPv6 firewall config step fails
|
||||||
Logs: [Include error from log file]
|
Logs: [Include error from log file]
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -43,8 +57,8 @@ For feature requests, please provide:
|
|||||||
|
|
||||||
1. **Fork & Clone**
|
1. **Fork & Clone**
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/YOUR_USERNAME/nasscript.git
|
git clone https://github.com/YOUR_USERNAME/nas.git
|
||||||
cd nasscript/nas
|
cd nas
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Create Feature Branch**
|
2. **Create Feature Branch**
|
||||||
@@ -59,6 +73,10 @@ For feature requests, please provide:
|
|||||||
# Make scripts executable
|
# Make scripts executable
|
||||||
chmod +x setup.sh tests/unit_tests.sh
|
chmod +x setup.sh tests/unit_tests.sh
|
||||||
|
|
||||||
|
# Install basic dependencies (if needed)
|
||||||
|
# bc calculator for version comparisons
|
||||||
|
# curl/wget for downloads
|
||||||
|
|
||||||
# Run unit tests
|
# Run unit tests
|
||||||
./tests/unit_tests.sh
|
./tests/unit_tests.sh
|
||||||
```
|
```
|
||||||
@@ -125,7 +143,7 @@ handle_error sudo systemctl start service
|
|||||||
**Variable Naming:**
|
**Variable Naming:**
|
||||||
```bash
|
```bash
|
||||||
# Constants: UPPER_CASE
|
# Constants: UPPER_CASE
|
||||||
readonly SCRIPT_VERSION="2.0.0"
|
readonly SCRIPT_VERSION="2.1.0"
|
||||||
|
|
||||||
# Global variables: UPPER_CASE
|
# Global variables: UPPER_CASE
|
||||||
DISTRO=""
|
DISTRO=""
|
||||||
@@ -134,6 +152,10 @@ CONFIG_FILE="/etc/nas_setup.conf"
|
|||||||
# Local variables: lower_case
|
# Local variables: lower_case
|
||||||
local username="$1"
|
local username="$1"
|
||||||
local config_path="/tmp/config"
|
local config_path="/tmp/config"
|
||||||
|
|
||||||
|
# Function-based lookups (v2.1+)
|
||||||
|
local pkg_manager=$(get_package_manager "$DISTRO")
|
||||||
|
local update_cmd=$(get_update_command "$DISTRO")
|
||||||
```
|
```
|
||||||
|
|
||||||
### Input Validation Requirements
|
### Input Validation Requirements
|
||||||
@@ -162,12 +184,19 @@ validate_custom_input() {
|
|||||||
- Review by maintainer
|
- Review by maintainer
|
||||||
- Testing in isolated environment
|
- Testing in isolated environment
|
||||||
- Documentation of security implications
|
- Documentation of security implications
|
||||||
|
- IPv6 security considerations (v2.1+)
|
||||||
|
|
||||||
**Security best practices:**
|
**Security best practices:**
|
||||||
- Never log sensitive information (passwords, keys)
|
- Never log sensitive information (passwords, keys, tokens)
|
||||||
- Validate all external input
|
- Validate all external input including IPv6 addresses
|
||||||
- Use parameterized commands
|
- Use parameterized commands
|
||||||
- Implement principle of least privilege
|
- Implement principle of least privilege
|
||||||
|
- Use modern cryptographic standards (Ed25519 SSH keys)
|
||||||
|
- Enable audit logging for security events
|
||||||
|
- Consider Mandatory Access Control (AppArmor/SELinux)
|
||||||
|
- Test IPv6 firewall rules thoroughly
|
||||||
|
|
||||||
|
**For security vulnerabilities, see our [Security Policy](SECURITY.md).**
|
||||||
|
|
||||||
### Testing Requirements
|
### Testing Requirements
|
||||||
|
|
||||||
@@ -214,16 +243,20 @@ test_new_function() {
|
|||||||
|
|
||||||
**CHANGELOG Updates:**
|
**CHANGELOG Updates:**
|
||||||
```markdown
|
```markdown
|
||||||
## [2.1.0] - 2025-06-17
|
## [2.1.0] - 2025-10-01
|
||||||
### Added
|
### 🚀 2025 Compatibility Update
|
||||||
- New feature description
|
#### Added
|
||||||
- Another enhancement
|
- IPv6 support throughout the system
|
||||||
|
- Modern Docker ecosystem with Compose plugin
|
||||||
|
- Enhanced security with Ed25519 SSH and auditd
|
||||||
|
|
||||||
### Changed
|
#### Changed
|
||||||
- Modified behavior description
|
- Updated distribution support to latest versions
|
||||||
|
- Modernized package management and GPG handling
|
||||||
|
|
||||||
### Fixed
|
#### Security
|
||||||
- Bug fix description
|
- IPv6 security considerations
|
||||||
|
- Enhanced audit logging and MAC integration
|
||||||
```
|
```
|
||||||
|
|
||||||
## 🧪 Testing Strategy
|
## 🧪 Testing Strategy
|
||||||
@@ -303,18 +336,19 @@ We follow [Semantic Versioning](https://semver.org/):
|
|||||||
|
|
||||||
### Release Checklist
|
### Release Checklist
|
||||||
|
|
||||||
- [ ] All tests pass
|
- [ ] All tests pass (including IPv6 validation)
|
||||||
- [ ] Documentation updated
|
- [ ] Documentation updated with new features
|
||||||
- [ ] CHANGELOG.md updated
|
- [ ] CHANGELOG.md updated with 2025 changes
|
||||||
- [ ] Version bumped in relevant files
|
- [ ] Version bumped in relevant files (v2.1.x)
|
||||||
- [ ] Security review completed
|
- [ ] Security review completed (Ed25519, auditd, MAC)
|
||||||
- [ ] Performance benchmarks acceptable
|
- [ ] IPv6 functionality tested on dual-stack networks
|
||||||
|
- [ ] Performance benchmarks acceptable with modern distributions
|
||||||
|
|
||||||
## 🤝 Community
|
## 🤝 Community
|
||||||
|
|
||||||
### Code of Conduct
|
### Code of Conduct
|
||||||
|
|
||||||
We follow the [Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/version/2/0/code_of_conduct/).
|
We follow the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md) for all community interactions.
|
||||||
|
|
||||||
### Communication
|
### Communication
|
||||||
|
|
||||||
|
|||||||
2
LICENSE
2
LICENSE
@@ -1,6 +1,6 @@
|
|||||||
MIT License
|
MIT License
|
||||||
|
|
||||||
Copyright (c) 2024 Sebastian Palencsár
|
Copyright (c) 2025 Sebastian Palencsár
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
|||||||
164
README.md
164
README.md
@@ -1,17 +1,17 @@
|
|||||||
# NAS Setup Script v2.0
|
# NAS Setup Script v2.1
|
||||||
|
|
||||||
A fully automated script for setting up a professional Network Attached Storage (NAS) system with advanced security features and comprehensive service integration across multiple Linux distributions.
|
A fully automated script for setting up a professional Network Attached Storage (NAS) system with advanced security features and comprehensive service integration across multiple Linux distributions.
|
||||||
|
|
||||||
## 🚀 New Features in v2.0
|
## 🚀 New Features in v2.1 - 2025 Compatibility Update
|
||||||
|
|
||||||
- **Enhanced Input Validation** with comprehensive error handling
|
- **Full IPv6 Support** throughout the entire system
|
||||||
- **Rollback Mechanism** for safe installation and recovery
|
- **Modern Distribution Support** (Ubuntu 24.04+, Fedora 41+, openSUSE 15.6+)
|
||||||
- **Unit Tests** for critical functions
|
- **Enhanced Security** with Ed25519 SSH keys, auditd logging, and MAC
|
||||||
- **Performance Optimizations** and improved logging functionality
|
- **Docker Compose Plugin** for modern container management
|
||||||
- **Interactive Configuration** with intelligent defaults
|
- **Dual-Stack Networking** with IPv4/IPv6 connectivity tests
|
||||||
- **Automatic Dependency Checks** and installation
|
- **Official Repository Sources** for all distributions
|
||||||
- **Advanced Firewall Configuration** with intrusion detection
|
- **Performance Optimizations** for modern hardware
|
||||||
- **Monitoring and Alerting** for system and security events
|
- **Enterprise-Grade Security** with comprehensive hardening
|
||||||
|
|
||||||
## 📋 Legal Notice
|
## 📋 Legal Notice
|
||||||
|
|
||||||
@@ -23,31 +23,34 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
|
|||||||
|
|
||||||
## 🖥️ Supported Distributions
|
## 🖥️ Supported Distributions
|
||||||
|
|
||||||
| Distribution | Minimum Version | Status | Tested |
|
| Distribution | Minimum Version | Status | Tested | IPv6 Support |
|
||||||
|--------------|----------------|--------|---------|
|
|--------------|----------------|--------|---------|--------------|
|
||||||
| Ubuntu | 20.04 LTS | ✅ Full Support | ✅ |
|
| Ubuntu | 24.04 LTS | ✅ Full Support | ✅ | ✅ Full |
|
||||||
| Debian | 11 (Bullseye) | ✅ Full Support | ✅ |
|
| Debian | 12 (Bookworm) | ✅ Full Support | ✅ | ✅ Full |
|
||||||
| Fedora | 35+ | ✅ Full Support | ✅ |
|
| Fedora | 41+ | ✅ Full Support | ✅ | ✅ Full |
|
||||||
| Arch Linux | Rolling | ✅ Full Support | ✅ |
|
| Arch Linux | Rolling | ✅ Full Support | ✅ | ✅ Full |
|
||||||
| openSUSE | Leap 15.4+ | ✅ Full Support | ✅ |
|
| openSUSE | Leap 15.6+ | ✅ Full Support | ✅ | ✅ Full |
|
||||||
|
|
||||||
## ✨ Features and Services
|
## ✨ Features and Services
|
||||||
|
|
||||||
### 🔧 Core System
|
### 🔧 Core System
|
||||||
- **Automatic Distribution Detection** with version validation
|
- **Robust Distribution Detection** with 5-method fallback system and container environment detection
|
||||||
- **Network Configuration** (static IP, gateway, DNS)
|
- **Advanced Version Validation** with regex parsing and bc calculator for precise comparisons
|
||||||
- **SSH Hardening** with custom port and security policies
|
- **Dual-Stack Network Configuration** (IPv4/IPv6 static IP, gateway, DNS)
|
||||||
|
- **SSH Hardening** with Ed25519 keys and custom port
|
||||||
- **User Management** with sudo privileges
|
- **User Management** with sudo privileges
|
||||||
- **System Updates** and automatic security updates
|
- **System Updates** and automatic security updates
|
||||||
|
|
||||||
### 🛡️ Security Features
|
### 🛡️ Security Features
|
||||||
- **UFW/Firewalld Configuration** with intelligent rules
|
- **UFW/Firewalld Configuration** with IPv6 support and intelligent rules
|
||||||
- **Fail2ban Integration** for brute-force attack protection
|
- **Fail2ban Integration** for brute-force attack protection
|
||||||
- **Rate Limiting** for critical services
|
- **Rate Limiting** for critical services (IPv4/IPv6)
|
||||||
- **IP Blocking Tools** for manual security measures
|
- **IP Blocking Tools** for manual security measures
|
||||||
- **Firewall Monitoring** with automatic alerts
|
- **Firewall Monitoring** with automatic alerts
|
||||||
- **Secure Shared Memory** implementation
|
- **Secure Shared Memory** implementation
|
||||||
- **Docker Content Trust** activation
|
- **Docker Content Trust** activation
|
||||||
|
- **Audit Logging** with comprehensive system monitoring
|
||||||
|
- **Mandatory Access Control** (AppArmor/SELinux integration)
|
||||||
|
|
||||||
### 📁 File Sharing
|
### 📁 File Sharing
|
||||||
- **Samba Configuration** with performance optimizations
|
- **Samba Configuration** with performance optimizations
|
||||||
@@ -56,30 +59,31 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
|
|||||||
- **Time Machine Support** for macOS backups
|
- **Time Machine Support** for macOS backups
|
||||||
|
|
||||||
### 🐳 Container Platform
|
### 🐳 Container Platform
|
||||||
- **Docker Installation** with optimized configuration
|
- **Docker Installation** from official repositories with optimized configuration
|
||||||
- **Docker Compose** for multi-container applications
|
- **Docker Compose Plugin** (v2.30.0+) for modern container orchestration
|
||||||
- **Portainer** for graphical container management
|
- **Portainer** for graphical container management with HTTPS
|
||||||
- **Secure Container Configuration** with best practices
|
- **Secure Container Configuration** with best practices and IPv6 support
|
||||||
|
|
||||||
### 📊 Monitoring and Management
|
### 📊 Monitoring and Management
|
||||||
- **Netdata** for real-time system monitoring
|
- **Netdata** for real-time system monitoring
|
||||||
- **Jellyfin** media server for multimedia content
|
- **Jellyfin** media server for multimedia content
|
||||||
- **Vaultwarden** for secure password management
|
- **Vaultwarden** for secure password management
|
||||||
- **System Performance Tracking** with automatic reports
|
- **System Performance Tracking** with automatic reports
|
||||||
|
- **Comprehensive Unit Testing** framework with extensive test coverage
|
||||||
|
|
||||||
## 🔧 System Requirements
|
## 🔧 System Requirements
|
||||||
|
|
||||||
### Minimum Hardware Requirements
|
### Minimum Hardware Requirements
|
||||||
- **CPU:** Dual-core processor (x86_64/AMD64)
|
- **CPU:** Dual-core processor (x86_64/AMD64)
|
||||||
- **RAM:** 2GB minimum, 4GB recommended
|
- **RAM:** 4GB minimum, 8GB recommended for Docker workloads
|
||||||
- **Storage:** 20GB for system, additional storage for NAS data
|
- **Storage:** 30GB for system, additional storage for NAS data
|
||||||
- **Network:** Gigabit Ethernet recommended
|
- **Network:** Gigabit Ethernet with IPv4/IPv6 support recommended
|
||||||
|
|
||||||
### Software Requirements
|
### Software Requirements
|
||||||
- Fresh installation of a supported Linux distribution
|
- Fresh installation of a supported Linux distribution
|
||||||
- systemd-based system
|
- systemd-based system
|
||||||
- Root access or sudo privileges
|
- Root access or sudo privileges
|
||||||
- Active internet connection for package downloads
|
- Active IPv4/IPv6 internet connection for package downloads
|
||||||
|
|
||||||
### Optional Requirements
|
### Optional Requirements
|
||||||
- **ARM64 Support:** Partially available (experimental)
|
- **ARM64 Support:** Partially available (experimental)
|
||||||
@@ -90,8 +94,8 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
|
|||||||
|
|
||||||
### 1. Clone Repository
|
### 1. Clone Repository
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/noordjonge/nasscript.git
|
git clone https://github.com/spalencsar/nas.git
|
||||||
cd nasscript/nas
|
cd nas
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2. Make Script Executable
|
### 2. Make Script Executable
|
||||||
@@ -116,21 +120,22 @@ The script guides you through an interactive configuration:
|
|||||||
|
|
||||||
### Network Settings
|
### Network Settings
|
||||||
- **SSH Port:** Default 39000 (customizable)
|
- **SSH Port:** Default 39000 (customizable)
|
||||||
- **Static IP:** Optionally configurable
|
- **Dual-Stack IP:** IPv4/IPv6 static IP configuration
|
||||||
- **Gateway and DNS:** Automatic detection with override capability
|
- **Gateway and DNS:** IPv4/IPv6 automatic detection with override capability
|
||||||
|
|
||||||
### Service Selection
|
### Service Selection
|
||||||
- **Docker:** Container platform
|
- **Docker:** Container platform with Compose plugin
|
||||||
- **NFS:** Network File System
|
- **NFS:** Network File System with IPv6 support
|
||||||
- **Netdata:** System monitoring
|
- **Netdata:** System monitoring
|
||||||
- **Vaultwarden:** Password manager
|
- **Vaultwarden:** Password manager with security hardening
|
||||||
- **Jellyfin:** Media server
|
- **Jellyfin:** Media server with modern GPG keys
|
||||||
- **Portainer:** Docker management
|
- **Portainer:** Docker management with HTTPS
|
||||||
|
|
||||||
### Security Configuration
|
### Security Configuration
|
||||||
- **Firewall Rules:** Automatic based on selected services
|
- **Firewall Rules:** IPv4/IPv6 automatic based on selected services
|
||||||
- **Fail2ban:** Protection against brute-force attacks
|
- **Fail2ban:** Protection against brute-force attacks
|
||||||
- **Rate Limiting:** Protection against DoS attacks
|
- **Rate Limiting:** IPv4/IPv6 protection against DoS attacks
|
||||||
|
- **SSH Keys:** Ed25519 key generation for enhanced security
|
||||||
|
|
||||||
## 📁 Directory Structure
|
## 📁 Directory Structure
|
||||||
|
|
||||||
@@ -141,6 +146,7 @@ nas/
|
|||||||
│ └── defaults.sh # Configuration variables and defaults
|
│ └── defaults.sh # Configuration variables and defaults
|
||||||
├── lib/
|
├── lib/
|
||||||
│ ├── common.sh # Common functions and validation
|
│ ├── common.sh # Common functions and validation
|
||||||
|
│ ├── detection.sh # Distribution and container detection
|
||||||
│ ├── logging.sh # Enhanced logging functionality
|
│ ├── logging.sh # Enhanced logging functionality
|
||||||
│ ├── network.sh # Network and SSH configuration
|
│ ├── network.sh # Network and SSH configuration
|
||||||
│ ├── firewall.sh # Firewall and security configuration
|
│ ├── firewall.sh # Firewall and security configuration
|
||||||
@@ -164,38 +170,41 @@ nas/
|
|||||||
|
|
||||||
## 🔗 Default Ports and Services
|
## 🔗 Default Ports and Services
|
||||||
|
|
||||||
| Service | Port | Protocol | Description |
|
| Service | Port | Protocol | Description | IPv6 Support |
|
||||||
|---------|------|----------|-------------|
|
|---------|------|----------|-------------|--------------|
|
||||||
| SSH | 39000 | TCP | Secure Shell Access |
|
| SSH | 39000 | TCP | Secure Shell Access | ✅ |
|
||||||
| Samba | 139, 445 | TCP | Windows File Sharing |
|
| Samba | 139, 445 | TCP | Windows File Sharing | ✅ |
|
||||||
| Samba | 137, 138 | UDP | NetBIOS Name Service |
|
| Samba | 137, 138 | UDP | NetBIOS Name Service | ✅ |
|
||||||
| NFS | 2049 | TCP | Network File System |
|
| NFS | 2049 | TCP | Network File System | ✅ |
|
||||||
| Netdata | 19999 | TCP | System Monitoring |
|
| Netdata | 19999 | TCP | System Monitoring | ✅ |
|
||||||
| Jellyfin | 8096 | TCP | Media Server Web Interface |
|
| Jellyfin | 8096 | TCP | Media Server Web Interface | ✅ |
|
||||||
| Jellyfin | 8920 | TCP | Media Server HTTPS |
|
| Jellyfin | 8920 | TCP | Media Server HTTPS | ✅ |
|
||||||
| Jellyfin | 1900 | UDP | DLNA Discovery |
|
| Jellyfin | 1900 | UDP | DLNA Discovery | ✅ |
|
||||||
| Portainer | 9000 | TCP | Docker Management |
|
| Portainer | 9000 | TCP | Docker Management (HTTPS) | ✅ |
|
||||||
| Vaultwarden | 8080 | TCP | Password Manager |
|
| Vaultwarden | 8080 | TCP | Password Manager | ✅ |
|
||||||
| Docker API | 2375, 2376 | TCP | Docker Remote API |
|
| Docker API | 2375, 2376 | TCP | Docker Remote API | ✅ |
|
||||||
|
|
||||||
## 🛡️ Security Features
|
## 🛡️ Security Features
|
||||||
|
|
||||||
### Advanced Firewall Configuration
|
### Advanced Firewall Configuration
|
||||||
- **UFW (Ubuntu/Debian/Arch):** Automatic rule configuration
|
- **UFW (Ubuntu/Debian/Arch):** IPv4/IPv6 rule configuration with local network rules
|
||||||
- **Firewalld (Fedora/openSUSE):** Zone-based security
|
- **Firewalld (Fedora/openSUSE):** Zone-based security with IPv6 rich rules
|
||||||
- **Rate Limiting:** Protection against DoS attacks
|
- **Rate Limiting:** IPv4/IPv6 protection against DoS attacks
|
||||||
- **IP Blocking Tools:** Manual security measures
|
- **IP Blocking Tools:** Manual security measures for both protocols
|
||||||
|
|
||||||
### Intrusion Detection
|
### Intrusion Detection & Audit
|
||||||
- **Fail2ban:** Automatic IP blocking for suspicious activities
|
- **Fail2ban:** Automatic IP blocking for suspicious activities
|
||||||
|
- **Auditd:** Comprehensive system auditing and logging
|
||||||
- **Log Monitoring:** Real-time security event monitoring
|
- **Log Monitoring:** Real-time security event monitoring
|
||||||
- **Alert System:** Notifications for security incidents
|
- **Alert System:** Notifications for security incidents
|
||||||
|
|
||||||
### SSH Hardening
|
### SSH Hardening & Access Control
|
||||||
|
- **Ed25519 Keys:** Modern cryptographic key generation
|
||||||
- **Custom Ports:** Reduction of automated attacks
|
- **Custom Ports:** Reduction of automated attacks
|
||||||
- **Key-based Authentication:** SSH key support
|
- **Key-based Authentication:** Enhanced security over passwords
|
||||||
- **Connection Limits:** Limiting concurrent connections
|
- **Connection Limits:** Limiting concurrent connections
|
||||||
- **Root Login Prohibition:** Enhanced security
|
- **Root Login Prohibition:** Enhanced security posture
|
||||||
|
- **Mandatory Access Control:** AppArmor/SELinux integration
|
||||||
|
|
||||||
## 📊 Monitoring and Maintenance
|
## 📊 Monitoring and Maintenance
|
||||||
|
|
||||||
@@ -266,10 +275,14 @@ The script offers automatic rollback on errors:
|
|||||||
#### Network Issues
|
#### Network Issues
|
||||||
```bash
|
```bash
|
||||||
# Check network configuration
|
# Check network configuration
|
||||||
ip addr show
|
ip addr show # IPv4/IPv6 addresses
|
||||||
ip route show
|
ip route show # Routing table
|
||||||
cat /etc/netplan/01-netcfg.yaml # Ubuntu/Debian
|
cat /etc/netplan/01-netcfg.yaml # Ubuntu/Debian network config
|
||||||
cat /etc/sysconfig/network-scripts/ifcfg-* # Fedora/openSUSE
|
|
||||||
|
# IPv6 specific checks
|
||||||
|
ip -6 addr show # IPv6 addresses only
|
||||||
|
ip -6 route show # IPv6 routing
|
||||||
|
ping6 google.com # IPv6 connectivity test
|
||||||
|
|
||||||
# Restart network services
|
# Restart network services
|
||||||
sudo netplan apply # Ubuntu/Debian
|
sudo netplan apply # Ubuntu/Debian
|
||||||
@@ -291,13 +304,17 @@ sudo journalctl -u samba -f
|
|||||||
|
|
||||||
#### Firewall Issues
|
#### Firewall Issues
|
||||||
```bash
|
```bash
|
||||||
# UFW status and rules
|
# UFW status and rules (IPv4/IPv6)
|
||||||
sudo ufw status numbered
|
sudo ufw status numbered
|
||||||
sudo ufw show raw
|
sudo ufw show raw
|
||||||
|
|
||||||
# Firewalld status and rules
|
# Firewalld status and rules (IPv4/IPv6)
|
||||||
sudo firewall-cmd --list-all-zones
|
sudo firewall-cmd --list-all-zones
|
||||||
sudo firewall-cmd --get-active-zones
|
sudo firewall-cmd --get-active-zones
|
||||||
|
|
||||||
|
# IPv6 specific firewall checks
|
||||||
|
sudo ip6tables -L -n # Direct IPv6 rules
|
||||||
|
sudo firewall-cmd --list-all --zone=public # Firewalld IPv6
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Permission Issues
|
#### Permission Issues
|
||||||
@@ -331,10 +348,13 @@ We welcome contributions to improve this project! Please read [CONTRIBUTING.md](
|
|||||||
## 📞 Support
|
## 📞 Support
|
||||||
|
|
||||||
### Community Support
|
### Community Support
|
||||||
1. [Browse Wiki](https://github.com/noordjonge/nasscript/wiki)
|
1. [Browse Wiki](https://github.com/spalencsar/nas/wiki)
|
||||||
2. [Search existing issues](https://github.com/noordjonge/nasscript/issues)
|
2. [Search existing issues](https://github.com/spalencsar/nas/issues)
|
||||||
3. Create new issue if needed
|
3. Create new issue if needed
|
||||||
|
|
||||||
|
### Security Issues
|
||||||
|
Please see our [Security Policy](SECURITY.md) for reporting security vulnerabilities.
|
||||||
|
|
||||||
### Professional Support
|
### Professional Support
|
||||||
For commercial support and custom solutions, contact the author.
|
For commercial support and custom solutions, contact the author.
|
||||||
|
|
||||||
@@ -352,8 +372,8 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
|
|||||||
## 👨💻 Author
|
## 👨💻 Author
|
||||||
|
|
||||||
**Sebastian Palencsár**
|
**Sebastian Palencsár**
|
||||||
- GitHub: [@noordjonge](https://github.com/noordjonge)
|
- GitHub: [@spalencsar](https://github.com/spalencsar)
|
||||||
- Project Repository: [NAS Script](https://github.com/noordjonge/nasscript)
|
- Project Repository: [NAS Script](https://github.com/spalencsar/nas)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
114
SECURITY.md
Normal file
114
SECURITY.md
Normal file
@@ -0,0 +1,114 @@
|
|||||||
|
# Security Policy
|
||||||
|
|
||||||
|
## 🔒 Security Overview
|
||||||
|
|
||||||
|
The NAS Setup Script takes security seriously. This document outlines our security policy, how to report vulnerabilities, and our commitment to maintaining a secure codebase.
|
||||||
|
|
||||||
|
## 🚨 Reporting Vulnerabilities
|
||||||
|
|
||||||
|
If you discover a security vulnerability in this project, please help us by reporting it responsibly.
|
||||||
|
|
||||||
|
### 📧 How to Report
|
||||||
|
|
||||||
|
**Please DO NOT report security vulnerabilities through public GitHub issues.**
|
||||||
|
|
||||||
|
Instead, please report security vulnerabilities by emailing:
|
||||||
|
- **Email:** moin@linuxcommand.dev
|
||||||
|
- **Subject:** `[SECURITY] NAS Setup Script Vulnerability Report`
|
||||||
|
|
||||||
|
### ⏰ Response Timeline
|
||||||
|
|
||||||
|
We will acknowledge your report within 48 hours and provide a more detailed response within 7 days indicating our next steps.
|
||||||
|
|
||||||
|
We will keep you informed about our progress throughout the process of fixing the vulnerability.
|
||||||
|
|
||||||
|
### 📋 What to Include
|
||||||
|
|
||||||
|
Please include the following information in your report:
|
||||||
|
- A clear description of the vulnerability
|
||||||
|
- Steps to reproduce the issue
|
||||||
|
- Potential impact and severity
|
||||||
|
- Any suggested fixes or mitigations
|
||||||
|
- Your contact information for follow-up
|
||||||
|
|
||||||
|
## 🛡️ Security Considerations
|
||||||
|
|
||||||
|
### Current Security Features
|
||||||
|
|
||||||
|
The NAS Setup Script includes several security measures:
|
||||||
|
|
||||||
|
- **Input Validation:** Comprehensive validation of all user inputs
|
||||||
|
- **SSH Hardening:** Ed25519 key generation and secure configurations
|
||||||
|
- **Firewall Management:** IPv4/IPv6 firewall rules with UFW/Firewalld
|
||||||
|
- **Intrusion Detection:** Fail2ban integration for brute-force protection
|
||||||
|
- **Audit Logging:** System auditing with auditd
|
||||||
|
- **Access Control:** Mandatory Access Control (AppArmor/SELinux)
|
||||||
|
- **Secure Defaults:** Conservative security settings by default
|
||||||
|
- **Distribution Detection:** Robust 5-method fallback system with container environment detection
|
||||||
|
- **Version Validation:** Advanced regex parsing and bc calculator for precise version comparisons
|
||||||
|
- **Unit Testing:** Comprehensive test suite (66+ test cases) ensuring code reliability
|
||||||
|
- **Container Security:** Detection and warnings for Docker/Podman/LXC/WSL environments
|
||||||
|
|
||||||
|
### Known Limitations
|
||||||
|
|
||||||
|
- **Root Access Required:** The script requires root/sudo privileges for system configuration
|
||||||
|
- **Network Dependencies:** Internet access required for package downloads
|
||||||
|
- **Service Exposure:** Configured services may expose ports to networks
|
||||||
|
- **User Responsibility:** End users are responsible for their network security
|
||||||
|
|
||||||
|
## 🔧 Security Updates
|
||||||
|
|
||||||
|
Security updates will be released as patch versions following semantic versioning:
|
||||||
|
- **Critical vulnerabilities:** Immediate patch release
|
||||||
|
- **High severity:** Within 7 days
|
||||||
|
- **Medium/Low severity:** Included in next minor release
|
||||||
|
|
||||||
|
## 📚 Best Practices for Users
|
||||||
|
|
||||||
|
### Before Installation
|
||||||
|
- Review the code and understand what the script does
|
||||||
|
- Test in a virtualized environment first
|
||||||
|
- Backup important data before running
|
||||||
|
- Ensure you have console access in case of issues
|
||||||
|
|
||||||
|
### After Installation
|
||||||
|
- Change default passwords immediately
|
||||||
|
- Review firewall rules and service configurations
|
||||||
|
- Monitor system logs regularly
|
||||||
|
- Keep the system updated with security patches
|
||||||
|
- Use strong, unique passwords for all services
|
||||||
|
|
||||||
|
### Network Security
|
||||||
|
- Place the NAS in a secure network segment
|
||||||
|
- Use VPN for remote access when possible
|
||||||
|
- Implement network segmentation
|
||||||
|
- Regularly audit network access logs
|
||||||
|
|
||||||
|
## 🏷️ Vulnerability Classification
|
||||||
|
|
||||||
|
We use the following severity levels:
|
||||||
|
|
||||||
|
- **Critical:** Remote code execution, privilege escalation, data loss
|
||||||
|
- **High:** Authentication bypass, significant data exposure
|
||||||
|
- **Medium:** Information disclosure, DoS attacks
|
||||||
|
- **Low:** Minor issues with limited impact
|
||||||
|
|
||||||
|
## 🤝 Security Hall of Fame
|
||||||
|
|
||||||
|
We appreciate security researchers who help make this project safer. With your permission, we'll acknowledge your contribution in our security hall of fame.
|
||||||
|
|
||||||
|
## 📞 Contact
|
||||||
|
|
||||||
|
For security-related questions or concerns:
|
||||||
|
- **Security Issues:** Use the reporting process above
|
||||||
|
- **General Security Questions:** Create a GitHub Discussion
|
||||||
|
- **Documentation Issues:** Submit a GitHub Issue
|
||||||
|
|
||||||
|
## 📜 Disclaimer
|
||||||
|
|
||||||
|
This software is provided "as is" without warranty. Users are responsible for their own security practices and should evaluate the suitability of this software for their specific use case.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Last updated: October 2025*</content>
|
||||||
|
<parameter name="filePath">/Volumes/homes/sebastian/Projekte/github/nas-main/SECURITY.md
|
||||||
@@ -3,7 +3,7 @@
|
|||||||
# Default configuration values for NAS setup script
|
# Default configuration values for NAS setup script
|
||||||
|
|
||||||
# Script metadata
|
# Script metadata
|
||||||
SCRIPT_VERSION="2.0.0"
|
SCRIPT_VERSION="2.1.0"
|
||||||
SCRIPT_NAME="NAS Setup Script"
|
SCRIPT_NAME="NAS Setup Script"
|
||||||
SCRIPT_AUTHOR="Sebastian Palencsár"
|
SCRIPT_AUTHOR="Sebastian Palencsár"
|
||||||
|
|
||||||
@@ -28,7 +28,7 @@ NETDATA_PORT="19999"
|
|||||||
|
|
||||||
# Docker configuration
|
# Docker configuration
|
||||||
DEFAULT_DOCKER_DATA_DIR="/var/lib/docker"
|
DEFAULT_DOCKER_DATA_DIR="/var/lib/docker"
|
||||||
DOCKER_COMPOSE_VERSION="2.24.0"
|
DOCKER_COMPOSE_VERSION="2.30.0"
|
||||||
|
|
||||||
# Application data directories
|
# Application data directories
|
||||||
VAULTWARDEN_DATA_DIR="/opt/vaultwarden"
|
VAULTWARDEN_DATA_DIR="/opt/vaultwarden"
|
||||||
@@ -36,7 +36,7 @@ JELLYFIN_DATA_DIR="/var/lib/jellyfin"
|
|||||||
PORTAINER_DATA_DIR="/opt/portainer"
|
PORTAINER_DATA_DIR="/opt/portainer"
|
||||||
|
|
||||||
# System requirements
|
# System requirements
|
||||||
MIN_DISK_SPACE_GB=20
|
MIN_DISK_SPACE_GB=30
|
||||||
MIN_RAM_MB=2048
|
MIN_RAM_MB=2048
|
||||||
RECOMMENDED_RAM_MB=4096
|
RECOMMENDED_RAM_MB=4096
|
||||||
|
|
||||||
@@ -65,35 +65,45 @@ NC='\033[0m' # No Color
|
|||||||
# Supported distributions
|
# Supported distributions
|
||||||
SUPPORTED_DISTROS=("ubuntu" "debian" "fedora" "arch" "opensuse")
|
SUPPORTED_DISTROS=("ubuntu" "debian" "fedora" "arch" "opensuse")
|
||||||
|
|
||||||
# Package managers by distribution
|
# Get package manager for distribution
|
||||||
declare -A PKG_MANAGERS=(
|
get_package_manager() {
|
||||||
["ubuntu"]="apt-get"
|
local distro="$1"
|
||||||
["debian"]="apt-get"
|
case "$distro" in
|
||||||
["fedora"]="dnf"
|
ubuntu|debian) echo "apt-get" ;;
|
||||||
["arch"]="pacman"
|
fedora) echo "dnf" ;;
|
||||||
["opensuse"]="zypper"
|
arch) echo "pacman" ;;
|
||||||
)
|
opensuse) echo "zypper" ;;
|
||||||
|
*) echo "unknown" ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
# Update commands by distribution
|
# Get update command for distribution
|
||||||
declare -A UPDATE_COMMANDS=(
|
get_update_command() {
|
||||||
["ubuntu"]="apt-get update && apt-get upgrade -y"
|
local distro="$1"
|
||||||
["debian"]="apt-get update && apt-get upgrade -y"
|
case "$distro" in
|
||||||
["fedora"]="dnf update -y"
|
ubuntu|debian) echo "apt-get update && apt-get upgrade -y" ;;
|
||||||
["arch"]="pacman -Syu --noconfirm"
|
fedora) echo "dnf update -y" ;;
|
||||||
["opensuse"]="zypper refresh && zypper update -y"
|
arch) echo "pacman -Syu --noconfirm" ;;
|
||||||
)
|
opensuse) echo "zypper refresh && zypper update -y" ;;
|
||||||
|
*) echo "unknown" ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
# Service ports
|
# Get service port for service
|
||||||
declare -A SERVICE_PORTS=(
|
get_service_port() {
|
||||||
["ssh"]="${DEFAULT_SSH_PORT}"
|
local service="$1"
|
||||||
["samba"]="139,445"
|
case "$service" in
|
||||||
["nfs"]="2049"
|
ssh) echo "${DEFAULT_SSH_PORT}" ;;
|
||||||
["netdata"]="${NETDATA_PORT}"
|
samba) echo "139,445" ;;
|
||||||
["vaultwarden"]="8080"
|
nfs) echo "2049" ;;
|
||||||
["jellyfin"]="8096"
|
netdata) echo "${NETDATA_PORT}" ;;
|
||||||
["portainer"]="9000"
|
vaultwarden) echo "8080" ;;
|
||||||
["docker"]="2375,2376"
|
jellyfin) echo "8096" ;;
|
||||||
)
|
portainer) echo "9000" ;;
|
||||||
|
docker) echo "2375,2376" ;;
|
||||||
|
*) echo "unknown" ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
# Default firewall rules
|
# Default firewall rules
|
||||||
FIREWALL_RULES=(
|
FIREWALL_RULES=(
|
||||||
|
|||||||
@@ -198,7 +198,7 @@ check_command() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
install_dependencies() {
|
install_dependencies() {
|
||||||
local dependencies=("curl" "wget" "git" "ufw" "htop" "tree")
|
local dependencies=("curl" "wget" "git" "ufw" "htop" "tree" "bc")
|
||||||
local missing_deps=()
|
local missing_deps=()
|
||||||
|
|
||||||
log_info "Checking system dependencies..."
|
log_info "Checking system dependencies..."
|
||||||
@@ -267,7 +267,8 @@ save_config() {
|
|||||||
|
|
||||||
if [[ -f "${CONFIG_FILE}" ]]; then
|
if [[ -f "${CONFIG_FILE}" ]]; then
|
||||||
if grep -q "^${key}=" "${CONFIG_FILE}"; then
|
if grep -q "^${key}=" "${CONFIG_FILE}"; then
|
||||||
sed -i "s/^${key}=.*/${key}=${value}/" "${CONFIG_FILE}"
|
# Use sed with proper escaping
|
||||||
|
sed -i.bak "s|^${key}=.*|${key}=${value}|" "${CONFIG_FILE}" && rm -f "${CONFIG_FILE}.bak"
|
||||||
else
|
else
|
||||||
echo "${key}=${value}" >> "${CONFIG_FILE}"
|
echo "${key}=${value}" >> "${CONFIG_FILE}"
|
||||||
fi
|
fi
|
||||||
@@ -332,8 +333,8 @@ get_system_info() {
|
|||||||
check_ubuntu_version() {
|
check_ubuntu_version() {
|
||||||
if [[ "$DISTRO" == "ubuntu" ]]; then
|
if [[ "$DISTRO" == "ubuntu" ]]; then
|
||||||
local version_major=$(echo "$DISTRO_VERSION" | cut -d'.' -f1)
|
local version_major=$(echo "$DISTRO_VERSION" | cut -d'.' -f1)
|
||||||
if [[ $version_major -lt 20 ]]; then
|
if [[ $version_major -lt 24 ]]; then
|
||||||
log_warning "Ubuntu version $DISTRO_VERSION is not officially supported. Minimum: 20.04"
|
log_warning "Ubuntu version $DISTRO_VERSION is not officially supported. Minimum: 24.04"
|
||||||
if ! ask_yes_no "Continue anyway?" "n"; then
|
if ! ask_yes_no "Continue anyway?" "n"; then
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|||||||
132
lib/detection.sh
Normal file
132
lib/detection.sh
Normal file
@@ -0,0 +1,132 @@
|
|||||||
|
# Distribution Detection Functions
|
||||||
|
# This file contains functions for detecting Linux distributions and versions
|
||||||
|
|
||||||
|
# Normalize version strings for consistent comparison
|
||||||
|
normalize_version() {
|
||||||
|
local version="$1"
|
||||||
|
|
||||||
|
# Handle common version formats - keep original format but ensure x.y.z structure
|
||||||
|
if [[ $version =~ ^([0-9]+)(\.([0-9]+))?(\.([0-9]+))?.* ]]; then
|
||||||
|
# Standard x.y.z format - ensure all parts exist
|
||||||
|
local major="${BASH_REMATCH[1]}"
|
||||||
|
local minor="${BASH_REMATCH[3]:-0}"
|
||||||
|
local patch="${BASH_REMATCH[5]:-0}"
|
||||||
|
echo "${major}.${minor}.${patch}"
|
||||||
|
elif [[ $version =~ ^([0-9]+)\.([0-9]+)[[:space:]]*\((.*)\)$ ]]; then
|
||||||
|
# Debian style: "12 (bookworm)" -> "12.0.0"
|
||||||
|
echo "${BASH_REMATCH[1]}.0.0"
|
||||||
|
elif [[ $version == "rolling" ]] || [[ $version == "unstable" ]]; then
|
||||||
|
# Rolling releases
|
||||||
|
echo "9999.0.0" # High version number for rolling releases
|
||||||
|
else
|
||||||
|
# Fallback: try to extract first number
|
||||||
|
local num_version=$(echo "$version" | grep -oP '\d+(\.\d+)*' | head -1)
|
||||||
|
if [[ -n "$num_version" ]]; then
|
||||||
|
echo "$num_version"
|
||||||
|
else
|
||||||
|
echo "0.0.0"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Version comparison function using bc for reliability
|
||||||
|
version_compare() {
|
||||||
|
local version1="$1"
|
||||||
|
local operator="$2"
|
||||||
|
local version2="$3"
|
||||||
|
|
||||||
|
# Convert versions to comparable format
|
||||||
|
local v1_num=$(echo "$version1" | tr '.' ' ' | awk '{printf "%d%02d%02d", $1, $2, $3}')
|
||||||
|
local v2_num=$(echo "$version2" | tr '.' ' ' | awk '{printf "%d%02d%02d", $1, $2, $3}')
|
||||||
|
|
||||||
|
case $operator in
|
||||||
|
">=") [[ $v1_num -ge $v2_num ]] ;;
|
||||||
|
">") [[ $v1_num -gt $v2_num ]] ;;
|
||||||
|
"<=") [[ $v1_num -le $v2_num ]] ;;
|
||||||
|
"<") [[ $v1_num -lt $v2_num ]] ;;
|
||||||
|
"="|"==") [[ $v1_num -eq $v2_num ]] ;;
|
||||||
|
"!=") [[ $v1_num -ne $v2_num ]] ;;
|
||||||
|
*) return 1 ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# Validate minimum version requirements
|
||||||
|
validate_minimum_version() {
|
||||||
|
local distro="$1"
|
||||||
|
local version="$2"
|
||||||
|
|
||||||
|
case $distro in
|
||||||
|
ubuntu)
|
||||||
|
if ! version_compare "$version" ">=" "24.04.0"; then
|
||||||
|
log_warning "Ubuntu version $version is below minimum requirement (24.04)"
|
||||||
|
log_warning "Some features may not work correctly"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
debian)
|
||||||
|
if ! version_compare "$version" ">=" "12.0.0"; then
|
||||||
|
log_warning "Debian version $version is below minimum requirement (12)"
|
||||||
|
log_warning "Some features may not work correctly"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
fedora)
|
||||||
|
if ! version_compare "$version" ">=" "41.0.0"; then
|
||||||
|
log_warning "Fedora version $version is below minimum requirement (41)"
|
||||||
|
log_warning "Some features may not work correctly"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
opensuse)
|
||||||
|
if ! version_compare "$version" ">=" "15.6.0"; then
|
||||||
|
log_warning "openSUSE version $version is below minimum requirement (15.6)"
|
||||||
|
log_warning "Some features may not work correctly"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
arch)
|
||||||
|
# Arch is rolling, always considered compatible
|
||||||
|
log_debug "Arch Linux rolling release detected - fully supported"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# Detect container environments that might affect behavior
|
||||||
|
detect_container_environment() {
|
||||||
|
local container_type=""
|
||||||
|
|
||||||
|
# Docker container detection
|
||||||
|
if [[ -f /.dockerenv ]] || grep -q docker /proc/1/cgroup 2>/dev/null; then
|
||||||
|
container_type="docker"
|
||||||
|
log_debug "Running inside Docker container"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Podman container detection
|
||||||
|
if [[ -f /.podmanenv ]] || grep -q podman /proc/1/cgroup 2>/dev/null; then
|
||||||
|
container_type="podman"
|
||||||
|
log_debug "Running inside Podman container"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# LXC/LXD detection
|
||||||
|
if [[ -f /proc/1/environ ]] && grep -q lxc /proc/1/environ 2>/dev/null; then
|
||||||
|
container_type="lxc"
|
||||||
|
log_debug "Running inside LXC container"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# WSL detection
|
||||||
|
if grep -q Microsoft /proc/version 2>/dev/null || [[ -f /proc/version ]] && grep -q WSL /proc/version; then
|
||||||
|
container_type="wsl"
|
||||||
|
log_debug "Running inside Windows Subsystem for Linux (WSL)"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ -n "$container_type" ]]; then
|
||||||
|
log_info "Container environment detected: $container_type"
|
||||||
|
export CONTAINER_TYPE="$container_type"
|
||||||
|
|
||||||
|
# Adjust behavior for containers
|
||||||
|
case $container_type in
|
||||||
|
docker|podman|lxc)
|
||||||
|
log_warning "Running in container - some system-level features may be limited"
|
||||||
|
;;
|
||||||
|
wsl)
|
||||||
|
log_warning "Running in WSL - Windows integration features may be limited"
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
fi
|
||||||
|
}
|
||||||
@@ -3,43 +3,52 @@
|
|||||||
install_docker() {
|
install_docker() {
|
||||||
log_info "Installing Docker..."
|
log_info "Installing Docker..."
|
||||||
|
|
||||||
# Update package index and install prerequisites
|
|
||||||
handle_error sudo apt-get update
|
|
||||||
handle_error sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common
|
|
||||||
|
|
||||||
# Add Docker's official GPG key
|
|
||||||
handle_error curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
|
|
||||||
|
|
||||||
# Add Docker's official APT repository
|
|
||||||
handle_error sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
|
|
||||||
|
|
||||||
# Update package index again
|
|
||||||
handle_error sudo apt-get update
|
|
||||||
|
|
||||||
# Install Docker CE
|
|
||||||
handle_error sudo apt-get install -y docker-ce
|
|
||||||
|
|
||||||
# Add user to the docker group
|
|
||||||
handle_error sudo usermod -aG docker "$NEW_USER"
|
|
||||||
|
|
||||||
case $DISTRO in
|
case $DISTRO in
|
||||||
ubuntu|debian)
|
ubuntu|debian)
|
||||||
handle_error sudo apt-get install -y docker.io
|
# Update package index and install prerequisites
|
||||||
|
handle_error sudo apt-get update
|
||||||
|
handle_error sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common
|
||||||
|
|
||||||
|
# Add Docker's official GPG key
|
||||||
|
handle_error curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
|
||||||
|
|
||||||
|
# Add Docker's official APT repository
|
||||||
|
handle_error echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||||||
|
|
||||||
|
# Update package index again
|
||||||
|
handle_error sudo apt-get update
|
||||||
|
|
||||||
|
# Install Docker CE and Compose plugin
|
||||||
|
handle_error sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||||||
;;
|
;;
|
||||||
fedora)
|
fedora)
|
||||||
handle_error sudo dnf install -y docker
|
# Add Docker repository
|
||||||
|
handle_error sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
|
||||||
|
|
||||||
|
# Install Docker CE
|
||||||
|
handle_error sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||||||
;;
|
;;
|
||||||
arch)
|
arch)
|
||||||
handle_error sudo pacman -S --noconfirm docker
|
# Install Docker from official Arch repos (usually up-to-date)
|
||||||
|
handle_error sudo pacman -S --noconfirm docker docker-compose
|
||||||
;;
|
;;
|
||||||
opensuse)
|
opensuse)
|
||||||
handle_error sudo zypper install -y docker
|
# Add Docker repository
|
||||||
|
handle_error sudo zypper addrepo https://download.docker.com/linux/opensuse/docker-ce.repo
|
||||||
|
handle_error sudo zypper refresh
|
||||||
|
|
||||||
|
# Install Docker CE
|
||||||
|
handle_error sudo zypper install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||||||
;;
|
;;
|
||||||
*)
|
*)
|
||||||
log_error "Unsupported Linux distribution: $DISTRO"
|
log_error "Unsupported Linux distribution: $DISTRO"
|
||||||
exit 1
|
exit 1
|
||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
# Add user to the docker group
|
||||||
|
handle_error sudo usermod -aG docker "$NEW_USER"
|
||||||
|
|
||||||
handle_error sudo systemctl enable docker
|
handle_error sudo systemctl enable docker
|
||||||
handle_error sudo systemctl start docker
|
handle_error sudo systemctl start docker
|
||||||
|
|
||||||
|
|||||||
@@ -23,6 +23,9 @@ configure_ufw() {
|
|||||||
# Reset UFW to defaults
|
# Reset UFW to defaults
|
||||||
sudo ufw --force reset
|
sudo ufw --force reset
|
||||||
|
|
||||||
|
# Enable IPv6 support
|
||||||
|
sudo sed -i 's/IPV6=no/IPV6=yes/' /etc/default/ufw
|
||||||
|
|
||||||
# Set default policies
|
# Set default policies
|
||||||
sudo ufw default deny incoming
|
sudo ufw default deny incoming
|
||||||
sudo ufw default allow outgoing
|
sudo ufw default allow outgoing
|
||||||
@@ -59,6 +62,10 @@ configure_firewalld() {
|
|||||||
# Set default zone
|
# Set default zone
|
||||||
sudo firewall-cmd --set-default-zone=public
|
sudo firewall-cmd --set-default-zone=public
|
||||||
|
|
||||||
|
# Ensure IPv6 support is active (firewalld supports it natively)
|
||||||
|
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv6" accept'
|
||||||
|
sudo firewall-cmd --reload
|
||||||
|
|
||||||
return 0
|
return 0
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -119,8 +126,12 @@ add_ufw_rules() {
|
|||||||
|
|
||||||
# Local network communication
|
# Local network communication
|
||||||
local local_networks=("192.168.0.0/16" "10.0.0.0/8" "172.16.0.0/12")
|
local local_networks=("192.168.0.0/16" "10.0.0.0/8" "172.16.0.0/12")
|
||||||
|
local local_ipv6_networks=("fe80::/10" "fc00::/7")
|
||||||
for network in "${local_networks[@]}"; do
|
for network in "${local_networks[@]}"; do
|
||||||
sudo ufw allow from "$network" comment "Local network"
|
sudo ufw allow from "$network" comment "Local IPv4 network"
|
||||||
|
done
|
||||||
|
for network in "${local_ipv6_networks[@]}"; do
|
||||||
|
sudo ufw allow from "$network" comment "Local IPv6 network"
|
||||||
done
|
done
|
||||||
|
|
||||||
log_success "UFW rules configured successfully"
|
log_success "UFW rules configured successfully"
|
||||||
@@ -177,6 +188,13 @@ add_firewalld_rules() {
|
|||||||
sudo firewall-cmd --permanent --add-port=8080/tcp
|
sudo firewall-cmd --permanent --add-port=8080/tcp
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
# Local network communication (IPv4 and IPv6)
|
||||||
|
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.0.0/16" accept'
|
||||||
|
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="10.0.0.0/8" accept'
|
||||||
|
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="172.16.0.0/12" accept'
|
||||||
|
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv6" source address="fe80::/10" accept'
|
||||||
|
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv6" source address="fc00::/7" accept'
|
||||||
|
|
||||||
# Reload firewalld
|
# Reload firewalld
|
||||||
sudo firewall-cmd --reload
|
sudo firewall-cmd --reload
|
||||||
|
|
||||||
@@ -216,7 +234,7 @@ configure_ip_blocking() {
|
|||||||
# Create script for manual IP blocking
|
# Create script for manual IP blocking
|
||||||
sudo tee /usr/local/bin/block-ip > /dev/null <<'EOF'
|
sudo tee /usr/local/bin/block-ip > /dev/null <<'EOF'
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
# Script to block IP addresses
|
# Script to block IP addresses (IPv4 and IPv6)
|
||||||
|
|
||||||
if [[ $# -ne 1 ]]; then
|
if [[ $# -ne 1 ]]; then
|
||||||
echo "Usage: $0 <IP_ADDRESS>"
|
echo "Usage: $0 <IP_ADDRESS>"
|
||||||
@@ -225,18 +243,25 @@ fi
|
|||||||
|
|
||||||
IP="$1"
|
IP="$1"
|
||||||
|
|
||||||
# Validate IP address
|
# Validate IP address (IPv4 or IPv6)
|
||||||
if [[ ! $IP =~ ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ ]]; then
|
if [[ ! $IP =~ ^([0-9]{1,3}\.){3}[0-9]{1,3}$ ]] && [[ ! $IP =~ ^([0-9a-fA-F:]+:+)+[0-9a-fA-F]*$ ]]; then
|
||||||
echo "Error: Invalid IP address format"
|
echo "Error: Invalid IP address format (IPv4 or IPv6)"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
# Determine family
|
||||||
|
if [[ $IP =~ : ]]; then
|
||||||
|
FAMILY="ipv6"
|
||||||
|
else
|
||||||
|
FAMILY="ipv4"
|
||||||
|
fi
|
||||||
|
|
||||||
# Block IP based on firewall type
|
# Block IP based on firewall type
|
||||||
if command -v ufw &>/dev/null; then
|
if command -v ufw &>/dev/null; then
|
||||||
ufw deny from "$IP"
|
ufw deny from "$IP"
|
||||||
echo "IP $IP blocked via UFW"
|
echo "IP $IP blocked via UFW"
|
||||||
elif command -v firewall-cmd &>/dev/null; then
|
elif command -v firewall-cmd &>/dev/null; then
|
||||||
firewall-cmd --permanent --add-rich-rule="rule family='ipv4' source address='$IP' reject"
|
firewall-cmd --permanent --add-rich-rule="rule family='$FAMILY' source address='$IP' reject"
|
||||||
firewall-cmd --reload
|
firewall-cmd --reload
|
||||||
echo "IP $IP blocked via firewalld"
|
echo "IP $IP blocked via firewalld"
|
||||||
else
|
else
|
||||||
@@ -253,7 +278,7 @@ EOF
|
|||||||
# Create script for unblocking IP addresses
|
# Create script for unblocking IP addresses
|
||||||
sudo tee /usr/local/bin/unblock-ip > /dev/null <<'EOF'
|
sudo tee /usr/local/bin/unblock-ip > /dev/null <<'EOF'
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
# Script to unblock IP addresses
|
# Script to unblock IP addresses (IPv4 and IPv6)
|
||||||
|
|
||||||
if [[ $# -ne 1 ]]; then
|
if [[ $# -ne 1 ]]; then
|
||||||
echo "Usage: $0 <IP_ADDRESS>"
|
echo "Usage: $0 <IP_ADDRESS>"
|
||||||
@@ -262,18 +287,25 @@ fi
|
|||||||
|
|
||||||
IP="$1"
|
IP="$1"
|
||||||
|
|
||||||
# Validate IP address
|
# Validate IP address (IPv4 or IPv6)
|
||||||
if [[ ! $IP =~ ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ ]]; then
|
if [[ ! $IP =~ ^([0-9]{1,3}\.){3}[0-9]{1,3}$ ]] && [[ ! $IP =~ ^([0-9a-fA-F:]+:+)+[0-9a-fA-F]*$ ]]; then
|
||||||
echo "Error: Invalid IP address format"
|
echo "Error: Invalid IP address format (IPv4 or IPv6)"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
# Determine family
|
||||||
|
if [[ $IP =~ : ]]; then
|
||||||
|
FAMILY="ipv6"
|
||||||
|
else
|
||||||
|
FAMILY="ipv4"
|
||||||
|
fi
|
||||||
|
|
||||||
# Unblock IP based on firewall type
|
# Unblock IP based on firewall type
|
||||||
if command -v ufw &>/dev/null; then
|
if command -v ufw &>/dev/null; then
|
||||||
ufw delete deny from "$IP"
|
ufw delete deny from "$IP"
|
||||||
echo "IP $IP unblocked via UFW"
|
echo "IP $IP unblocked via UFW"
|
||||||
elif command -v firewall-cmd &>/dev/null; then
|
elif command -v firewall-cmd &>/dev/null; then
|
||||||
firewall-cmd --permanent --remove-rich-rule="rule family='ipv4' source address='$IP' reject"
|
firewall-cmd --permanent --remove-rich-rule="rule family='$FAMILY' source address='$IP' reject"
|
||||||
firewall-cmd --reload
|
firewall-cmd --reload
|
||||||
echo "IP $IP unblocked via firewalld"
|
echo "IP $IP unblocked via firewalld"
|
||||||
else
|
else
|
||||||
|
|||||||
@@ -1,11 +1,36 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
check_internet_connection() {
|
check_internet_connection() {
|
||||||
log_info "Checking internet connection..."
|
log_info "Checking internet connection (IPv4 and IPv6)..."
|
||||||
if ping -c 1 google.com &> /dev/null; then
|
|
||||||
log_info "Internet connection is active."
|
local ipv4_hosts=("8.8.8.8" "1.1.1.1" "google.com")
|
||||||
else
|
local ipv6_hosts=("2001:4860:4860::8888" "2606:4700:4700::1111" "google.com")
|
||||||
log_error "No internet connection. Please check your network settings."
|
local success=false
|
||||||
|
|
||||||
|
# Test IPv4
|
||||||
|
for host in "${ipv4_hosts[@]}"; do
|
||||||
|
if ping -c 1 -W 5 "$host" &>/dev/null; then
|
||||||
|
log_success "IPv4 internet connectivity confirmed (via $host)"
|
||||||
|
success=true
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
# Test IPv6 if IPv4 failed or to confirm dual-stack
|
||||||
|
if [[ "$success" == false ]] || true; then # Always test IPv6 for completeness
|
||||||
|
for host in "${ipv6_hosts[@]}"; do
|
||||||
|
if ping6 -c 1 -W 5 "$host" &>/dev/null; then
|
||||||
|
log_success "IPv6 internet connectivity confirmed (via $host)"
|
||||||
|
success=true
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ "$success" == false ]]; then
|
||||||
|
log_error "No internet connection detected (IPv4 or IPv6). Please check your network settings."
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
log_info "Internet connection check completed."
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -25,14 +25,15 @@ install_jellyfin() {
|
|||||||
case $DISTRO in
|
case $DISTRO in
|
||||||
ubuntu|debian)
|
ubuntu|debian)
|
||||||
handle_error sudo apt-get update
|
handle_error sudo apt-get update
|
||||||
handle_error sudo apt-get install -y apt-transport-https software-properties-common
|
handle_error sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common
|
||||||
handle_error wget -O - https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo apt-key add -
|
handle_error curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/jellyfin.gpg
|
||||||
handle_error sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/$(lsb_release -cs) main"
|
handle_error echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/jellyfin.gpg] https://repo.jellyfin.org/$(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list > /dev/null
|
||||||
handle_error sudo apt-get update
|
handle_error sudo apt-get update
|
||||||
handle_error sudo apt-get install -y jellyfin
|
handle_error sudo apt-get install -y jellyfin
|
||||||
;;
|
;;
|
||||||
fedora)
|
fedora)
|
||||||
handle_error sudo dnf install -y https://repo.jellyfin.org/releases/server/fedora/releases/jellyfin-server.rpm
|
handle_error sudo dnf config-manager --add-repo https://repo.jellyfin.org/releases/server/fedora/jellyfin.repo
|
||||||
|
handle_error sudo dnf install -y jellyfin
|
||||||
;;
|
;;
|
||||||
arch)
|
arch)
|
||||||
handle_error sudo pacman -S --noconfirm jellyfin
|
handle_error sudo pacman -S --noconfirm jellyfin
|
||||||
|
|||||||
@@ -5,11 +5,31 @@
|
|||||||
install_netdata() {
|
install_netdata() {
|
||||||
log_info "Installing Netdata..."
|
log_info "Installing Netdata..."
|
||||||
|
|
||||||
# Install dependencies
|
case $DISTRO in
|
||||||
handle_error sudo apt-get update
|
ubuntu|debian)
|
||||||
handle_error sudo apt-get install -y curl git
|
# Install dependencies
|
||||||
|
handle_error sudo apt-get update
|
||||||
|
handle_error sudo apt-get install -y curl git
|
||||||
|
;;
|
||||||
|
fedora)
|
||||||
|
# Install dependencies
|
||||||
|
handle_error sudo dnf install -y curl git
|
||||||
|
;;
|
||||||
|
arch)
|
||||||
|
# Install dependencies
|
||||||
|
handle_error sudo pacman -S --noconfirm curl git
|
||||||
|
;;
|
||||||
|
opensuse)
|
||||||
|
# Install dependencies
|
||||||
|
handle_error sudo zypper install -y curl git
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
log_error "Unsupported Linux distribution: $DISTRO"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
# Install Netdata from GitHub
|
# Install Netdata from GitHub (works across distributions)
|
||||||
handle_error bash <(curl -Ss https://my-netdata.io/kickstart.sh) --stable-channel --disable-telemetry
|
handle_error bash <(curl -Ss https://my-netdata.io/kickstart.sh) --stable-channel --disable-telemetry
|
||||||
|
|
||||||
handle_error sudo systemctl enable netdata
|
handle_error sudo systemctl enable netdata
|
||||||
|
|||||||
@@ -59,7 +59,7 @@ configure_netplan() {
|
|||||||
return 1
|
return 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Create new netplan configuration
|
# Create new netplan configuration (IPv4 and IPv6)
|
||||||
cat <<EOF | sudo tee "$netplan_file" > /dev/null
|
cat <<EOF | sudo tee "$netplan_file" > /dev/null
|
||||||
network:
|
network:
|
||||||
version: 2
|
version: 2
|
||||||
@@ -71,7 +71,7 @@ network:
|
|||||||
- to: default
|
- to: default
|
||||||
via: $gateway_ip
|
via: $gateway_ip
|
||||||
nameservers:
|
nameservers:
|
||||||
addresses: [$dns_ip, 8.8.8.8]
|
addresses: [$dns_ip, 8.8.8.8, 2001:4860:4860::8888]
|
||||||
dhcp4: false
|
dhcp4: false
|
||||||
dhcp6: false
|
dhcp6: false
|
||||||
EOF
|
EOF
|
||||||
|
|||||||
45
lib/nfs.sh
45
lib/nfs.sh
@@ -1,7 +1,8 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
install_nfs() {
|
install_nfs() {
|
||||||
log_info "Installing NFS..."
|
log_info "Installing and configuring NFS..."
|
||||||
|
|
||||||
case $DISTRO in
|
case $DISTRO in
|
||||||
ubuntu|debian)
|
ubuntu|debian)
|
||||||
handle_error sudo apt-get install -y nfs-kernel-server
|
handle_error sudo apt-get install -y nfs-kernel-server
|
||||||
@@ -20,5 +21,45 @@ install_nfs() {
|
|||||||
exit 1
|
exit 1
|
||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
log_info "NFS installation completed."
|
|
||||||
|
# Create NFS export directory
|
||||||
|
local export_dir="${NFS_EXPORT_DIR:-/srv/nfs}"
|
||||||
|
sudo mkdir -p "$export_dir"
|
||||||
|
sudo chown nobody:nogroup "$export_dir"
|
||||||
|
sudo chmod 755 "$export_dir"
|
||||||
|
|
||||||
|
# Configure NFS exports
|
||||||
|
local exports_file="/etc/exports"
|
||||||
|
backup_config "$exports_file"
|
||||||
|
|
||||||
|
echo "$export_dir *(rw,sync,no_subtree_check,no_root_squash)" | sudo tee -a "$exports_file" > /dev/null
|
||||||
|
|
||||||
|
# Export NFS shares
|
||||||
|
handle_error sudo exportfs -a
|
||||||
|
|
||||||
|
# Start and enable NFS services
|
||||||
|
case $DISTRO in
|
||||||
|
ubuntu|debian|opensuse)
|
||||||
|
handle_error sudo systemctl enable nfs-kernel-server
|
||||||
|
handle_error sudo systemctl start nfs-kernel-server
|
||||||
|
;;
|
||||||
|
fedora|arch)
|
||||||
|
handle_error sudo systemctl enable nfs-server
|
||||||
|
handle_error sudo systemctl start nfs-server
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# Open firewall for NFS
|
||||||
|
if command -v ufw &>/dev/null; then
|
||||||
|
sudo ufw allow 2049/tcp comment "NFS"
|
||||||
|
sudo ufw allow 111/tcp comment "NFS Portmapper"
|
||||||
|
sudo ufw allow 111/udp comment "NFS Portmapper"
|
||||||
|
elif command -v firewall-cmd &>/dev/null; then
|
||||||
|
sudo firewall-cmd --permanent --add-service=nfs
|
||||||
|
sudo firewall-cmd --permanent --add-service=rpc-bind
|
||||||
|
sudo firewall-cmd --permanent --add-service=mountd
|
||||||
|
sudo firewall-cmd --reload
|
||||||
|
fi
|
||||||
|
|
||||||
|
log_info "NFS installation and configuration completed. Export directory: $export_dir"
|
||||||
}
|
}
|
||||||
|
|||||||
115
lib/portainer.sh
115
lib/portainer.sh
@@ -1,82 +1,47 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# portainer.sh - Script to install Portainer on various Linux distributions
|
# Portainer installation and configuration script (2025-ready)
|
||||||
|
|
||||||
# Function to install Portainer on Ubuntu
|
install_portainer() {
|
||||||
install_portainer_ubuntu() {
|
log_info "Installing Portainer..."
|
||||||
sudo apt-get update
|
|
||||||
sudo apt-get install -y docker.io
|
# Docker muss installiert und aktiv sein
|
||||||
sudo systemctl start docker
|
if ! command -v docker &>/dev/null; then
|
||||||
sudo systemctl enable docker
|
log_error "Docker ist nicht installiert. Bitte Docker zuerst installieren."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Portainer-Volume anlegen
|
||||||
sudo docker volume create portainer_data
|
sudo docker volume create portainer_data
|
||||||
sudo docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
|
|
||||||
|
# Vorherigen Portainer-Container stoppen und entfernen, falls vorhanden
|
||||||
|
if sudo docker ps -a --format '{{.Names}}' | grep -q '^portainer$'; then
|
||||||
|
sudo docker stop portainer || true
|
||||||
|
sudo docker rm portainer || true
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Aktuelles Portainer-Image holen
|
||||||
|
sudo docker pull portainer/portainer-ce:latest
|
||||||
|
|
||||||
|
# Portainer starten (Web: Port 9000, Agent: 8000)
|
||||||
|
sudo docker run -d \
|
||||||
|
--name portainer \
|
||||||
|
--restart=always \
|
||||||
|
-p 9000:9000 \
|
||||||
|
-p 9443:9443 \
|
||||||
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
||||||
|
-v portainer_data:/data \
|
||||||
|
portainer/portainer-ce:latest
|
||||||
|
|
||||||
|
log_success "Portainer wurde erfolgreich installiert und läuft auf Port 9000 (HTTP) und 9443 (HTTPS)."
|
||||||
}
|
}
|
||||||
|
|
||||||
# Function to install Portainer on Debian
|
# Logging-Funktionen bereitstellen, falls nicht vorhanden
|
||||||
install_portainer_debian() {
|
if ! command -v log_info &>/dev/null; then
|
||||||
sudo apt-get update
|
log_info() { echo "[INFO] $1"; }
|
||||||
sudo apt-get install -y docker.io
|
log_success() { echo "[SUCCESS] $1"; }
|
||||||
sudo systemctl start docker
|
log_error() { echo "[ERROR] $1" >&2; }
|
||||||
sudo systemctl enable docker
|
|
||||||
sudo docker volume create portainer_data
|
|
||||||
sudo docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
|
|
||||||
}
|
|
||||||
|
|
||||||
# Function to install Portainer on Fedora
|
|
||||||
install_portainer_fedora() {
|
|
||||||
sudo dnf -y update
|
|
||||||
sudo dnf -y install docker
|
|
||||||
sudo systemctl start docker
|
|
||||||
sudo systemctl enable docker
|
|
||||||
sudo docker volume create portainer_data
|
|
||||||
sudo docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
|
|
||||||
}
|
|
||||||
|
|
||||||
# Function to install Portainer on Arch Linux
|
|
||||||
install_portainer_arch() {
|
|
||||||
sudo pacman -Syu --noconfirm
|
|
||||||
sudo pacman -S --noconfirm docker
|
|
||||||
sudo systemctl start docker
|
|
||||||
sudo systemctl enable docker
|
|
||||||
sudo docker volume create portainer_data
|
|
||||||
sudo docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
|
|
||||||
}
|
|
||||||
|
|
||||||
# Function to install Portainer on openSUSE
|
|
||||||
install_portainer_opensuse() {
|
|
||||||
sudo zypper refresh
|
|
||||||
sudo zypper install -y docker
|
|
||||||
sudo systemctl start docker
|
|
||||||
sudo systemctl enable docker
|
|
||||||
sudo docker volume create portainer_data
|
|
||||||
sudo docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
|
|
||||||
}
|
|
||||||
|
|
||||||
# Main script logic to detect the distribution and call the appropriate function
|
|
||||||
if [ -f /etc/os-release ]; then
|
|
||||||
. /etc/os-release
|
|
||||||
case "$ID" in
|
|
||||||
ubuntu)
|
|
||||||
install_portainer_ubuntu
|
|
||||||
;;
|
|
||||||
debian)
|
|
||||||
install_portainer_debian
|
|
||||||
;;
|
|
||||||
fedora)
|
|
||||||
install_portainer_fedora
|
|
||||||
;;
|
|
||||||
arch)
|
|
||||||
install_portainer_arch
|
|
||||||
;;
|
|
||||||
opensuse)
|
|
||||||
install_portainer_opensuse
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
echo "Unsupported distribution: $ID"
|
|
||||||
exit 1
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
else
|
|
||||||
echo "Cannot detect the operating system."
|
|
||||||
exit 1
|
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
# Hauptlogik
|
||||||
|
install_portainer
|
||||||
261
lib/security.sh
261
lib/security.sh
@@ -1,17 +1,17 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# Security configuration script
|
# Security configuration script (2025-enhanced)
|
||||||
|
|
||||||
secure_shared_memory() {
|
secure_shared_memory() {
|
||||||
log_info "Securing shared memory..."
|
log_info "Securing shared memory..."
|
||||||
handle_error sudo cp /etc/fstab /etc/fstab.bak
|
handle_error sudo cp /etc/fstab /etc/fstab.bak
|
||||||
echo "tmpfs /run/shm tmpfs defaults,noexec,nosuid 0 0" | sudo tee -a /etc/fstab
|
echo "tmpfs /run/shm tmpfs defaults,noexec,nosuid 0 0" | sudo tee -a /etc/fstab
|
||||||
handle_error sudo mount -o remount /run/shm
|
handle_error sudo mount -o remount /run/shm
|
||||||
log_info "Shared memory secured."
|
log_success "Shared memory secured."
|
||||||
}
|
}
|
||||||
|
|
||||||
install_fail2ban() {
|
install_fail2ban() {
|
||||||
log_info "Installing Fail2Ban..."
|
log_info "Installing and configuring Fail2Ban..."
|
||||||
case $DISTRO in
|
case $DISTRO in
|
||||||
ubuntu|debian)
|
ubuntu|debian)
|
||||||
handle_error sudo apt-get update
|
handle_error sudo apt-get update
|
||||||
@@ -31,7 +31,260 @@ install_fail2ban() {
|
|||||||
exit 1
|
exit 1
|
||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
# Backup default config
|
||||||
|
backup_config /etc/fail2ban/jail.local
|
||||||
|
|
||||||
|
# Configure Fail2Ban for SSH and other services
|
||||||
|
sudo tee /etc/fail2ban/jail.local > /dev/null <<EOF
|
||||||
|
[DEFAULT]
|
||||||
|
bantime = 3600
|
||||||
|
findtime = 600
|
||||||
|
maxretry = 3
|
||||||
|
|
||||||
|
[sshd]
|
||||||
|
enabled = true
|
||||||
|
port = ${DEFAULT_SSH_PORT:-22}
|
||||||
|
logpath = %(sshd_log)s
|
||||||
|
|
||||||
|
[dropbear]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[selinux-ssh]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[nginx-http-auth]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[nginx-noscript]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[nginx-badbots]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[nginx-noproxy]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[nginx-req-limit]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[nginx-botsearch]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[phpmyadmin-syslog]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[roundcube-auth]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[openhab-auth]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[squid]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[nginx-ddos]
|
||||||
|
enabled = false
|
||||||
|
|
||||||
|
[recidive]
|
||||||
|
enabled = true
|
||||||
|
EOF
|
||||||
|
|
||||||
handle_error sudo systemctl enable fail2ban
|
handle_error sudo systemctl enable fail2ban
|
||||||
handle_error sudo systemctl start fail2ban
|
handle_error sudo systemctl start fail2ban
|
||||||
log_info "Fail2Ban installation completed."
|
log_success "Fail2Ban installation and configuration completed."
|
||||||
|
}
|
||||||
|
|
||||||
|
# Harden SSH configuration
|
||||||
|
harden_ssh() {
|
||||||
|
log_info "Hardening SSH configuration..."
|
||||||
|
|
||||||
|
local ssh_config="/etc/ssh/sshd_config"
|
||||||
|
backup_config "$ssh_config"
|
||||||
|
|
||||||
|
# Apply security hardening
|
||||||
|
sudo sed -i 's/#PermitRootLogin yes/PermitRootLogin no/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#PasswordAuthentication yes/PasswordAuthentication no/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#PubkeyAuthentication yes/PubkeyAuthentication yes/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#AuthorizedKeysFile/AuthorizedKeysFile/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#PermitEmptyPasswords no/PermitEmptyPasswords no/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#ChallengeResponseAuthentication no/ChallengeResponseAuthentication no/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#UsePAM yes/UsePAM yes/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#X11Forwarding yes/X11Forwarding no/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#ClientAliveInterval 0/ClientAliveInterval 300/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#ClientAliveCountMax 3/ClientAliveCountMax 2/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#MaxAuthTries 6/MaxAuthTries 3/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#LoginGraceTime 2m/LoginGraceTime 60/' "$ssh_config"
|
||||||
|
sudo sed -i 's/#Protocol 2/Protocol 2/' "$ssh_config"
|
||||||
|
|
||||||
|
# Test SSH config
|
||||||
|
if sudo sshd -t; then
|
||||||
|
sudo systemctl restart sshd
|
||||||
|
log_success "SSH hardened successfully."
|
||||||
|
else
|
||||||
|
log_error "SSH configuration invalid. Restoring backup."
|
||||||
|
sudo cp "${ssh_config}.bak" "$ssh_config"
|
||||||
|
sudo systemctl restart sshd
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Configure AppArmor/SELinux
|
||||||
|
configure_mandatory_access_control() {
|
||||||
|
log_info "Configuring Mandatory Access Control..."
|
||||||
|
|
||||||
|
case $DISTRO in
|
||||||
|
ubuntu|debian)
|
||||||
|
# AppArmor
|
||||||
|
if command -v apparmor_status &>/dev/null; then
|
||||||
|
sudo systemctl enable apparmor
|
||||||
|
sudo systemctl start apparmor
|
||||||
|
log_success "AppArmor enabled."
|
||||||
|
else
|
||||||
|
log_warning "AppArmor not available."
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
fedora|opensuse)
|
||||||
|
# SELinux
|
||||||
|
if command -v setenforce &>/dev/null; then
|
||||||
|
sudo setenforce 1
|
||||||
|
sudo sed -i 's/SELINUX=permissive/SELINUX=enforcing/' /etc/selinux/config
|
||||||
|
log_success "SELinux enabled in enforcing mode."
|
||||||
|
else
|
||||||
|
log_warning "SELinux not available."
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
arch)
|
||||||
|
# AppArmor on Arch (optional)
|
||||||
|
if pacman -Q apparmor &>/dev/null; then
|
||||||
|
sudo systemctl enable apparmor
|
||||||
|
sudo systemctl start apparmor
|
||||||
|
log_success "AppArmor enabled on Arch."
|
||||||
|
else
|
||||||
|
log_info "AppArmor not installed on Arch. Consider installing for better security."
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
log_warning "Mandatory Access Control not configured for $DISTRO."
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
# Install and configure auditd
|
||||||
|
install_auditd() {
|
||||||
|
log_info "Installing and configuring auditd..."
|
||||||
|
|
||||||
|
case $DISTRO in
|
||||||
|
ubuntu|debian)
|
||||||
|
handle_error sudo apt-get install -y auditd audispd-plugins
|
||||||
|
;;
|
||||||
|
fedora)
|
||||||
|
handle_error sudo dnf install -y audit audit-libs
|
||||||
|
;;
|
||||||
|
arch)
|
||||||
|
handle_error sudo pacman -S --noconfirm audit
|
||||||
|
;;
|
||||||
|
opensuse)
|
||||||
|
handle_error sudo zypper install -y audit
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
log_error "auditd not supported on $DISTRO"
|
||||||
|
return 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# Configure audit rules
|
||||||
|
sudo tee -a /etc/audit/rules.d/audit.rules > /dev/null <<EOF
|
||||||
|
# NAS Security Audit Rules
|
||||||
|
-w /etc/passwd -p wa -k passwd_changes
|
||||||
|
-w /etc/shadow -p wa -k shadow_changes
|
||||||
|
-w /etc/group -p wa -k group_changes
|
||||||
|
-w /etc/sudoers -p wa -k sudoers_changes
|
||||||
|
-w /var/log/auth.log -p wa -k auth_logs
|
||||||
|
-w /var/log/sudo.log -p wa -k sudo_logs
|
||||||
|
-a always,exit -F arch=b64 -S execve -F key=executed_commands
|
||||||
|
EOF
|
||||||
|
|
||||||
|
handle_error sudo systemctl enable auditd
|
||||||
|
handle_error sudo systemctl start auditd
|
||||||
|
log_success "auditd installed and configured."
|
||||||
|
}
|
||||||
|
|
||||||
|
# Disable unnecessary services
|
||||||
|
disable_unnecessary_services() {
|
||||||
|
log_info "Disabling unnecessary services..."
|
||||||
|
|
||||||
|
local services_to_disable=("cups" "bluetooth" "avahi-daemon" "ModemManager")
|
||||||
|
|
||||||
|
for service in "${services_to_disable[@]}"; do
|
||||||
|
if systemctl list-unit-files --type=service | grep -q "^${service}.service"; then
|
||||||
|
sudo systemctl disable "$service" 2>/dev/null || true
|
||||||
|
sudo systemctl stop "$service" 2>/dev/null || true
|
||||||
|
log_info "Disabled service: $service"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
log_success "Unnecessary services disabled."
|
||||||
|
}
|
||||||
|
|
||||||
|
# Configure automatic security updates
|
||||||
|
configure_security_updates() {
|
||||||
|
log_info "Configuring automatic security updates..."
|
||||||
|
|
||||||
|
case $DISTRO in
|
||||||
|
ubuntu|debian)
|
||||||
|
handle_error sudo apt-get install -y unattended-upgrades
|
||||||
|
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||||
|
;;
|
||||||
|
fedora)
|
||||||
|
handle_error sudo dnf install -y dnf-automatic
|
||||||
|
sudo systemctl enable --now dnf-automatic-install.timer
|
||||||
|
;;
|
||||||
|
arch)
|
||||||
|
log_info "Arch Linux: Security updates via pacman -Syu recommended"
|
||||||
|
;;
|
||||||
|
opensuse)
|
||||||
|
handle_error sudo zypper install -y yast2-online-update-configuration
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
log_success "Automatic security updates configured."
|
||||||
|
}
|
||||||
|
|
||||||
|
# Generate SSH keys for admin user
|
||||||
|
generate_ssh_keys() {
|
||||||
|
local user="${ADMIN_USER:-$NEW_USER}"
|
||||||
|
local ssh_dir="/home/$user/.ssh"
|
||||||
|
|
||||||
|
if [[ -z "$user" ]]; then
|
||||||
|
log_warning "No admin user defined, skipping SSH key generation."
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
log_info "Generating SSH keys for user $user..."
|
||||||
|
|
||||||
|
sudo mkdir -p "$ssh_dir"
|
||||||
|
sudo chown "$user:$user" "$ssh_dir"
|
||||||
|
sudo chmod 700 "$ssh_dir"
|
||||||
|
|
||||||
|
# Generate Ed25519 key (more secure than RSA)
|
||||||
|
sudo -u "$user" ssh-keygen -t ed25519 -f "$ssh_dir/id_ed25519" -N "" -C "NAS-$user-$(date +%Y%m%d)"
|
||||||
|
|
||||||
|
log_success "SSH keys generated. Public key: $ssh_dir/id_ed25519.pub"
|
||||||
|
log_info "Add the public key to authorized_keys for passwordless login."
|
||||||
|
}
|
||||||
|
|
||||||
|
# Main security configuration function
|
||||||
|
configure_security() {
|
||||||
|
log_info "=== Security Configuration ==="
|
||||||
|
|
||||||
|
secure_shared_memory
|
||||||
|
install_fail2ban
|
||||||
|
harden_ssh
|
||||||
|
configure_mandatory_access_control
|
||||||
|
install_auditd
|
||||||
|
disable_unnecessary_services
|
||||||
|
configure_security_updates
|
||||||
|
generate_ssh_keys
|
||||||
|
|
||||||
|
log_success "Security configuration completed."
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,38 +1,95 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# unattended-upgrades.sh
|
# unattended-upgrades.sh - Configure automatic security updates (2025-enhanced)
|
||||||
# This script sets up unattended upgrades for various Linux distributions
|
|
||||||
|
|
||||||
set -e
|
configure_unattended_upgrades() {
|
||||||
|
log_info "Configuring automatic security updates..."
|
||||||
|
|
||||||
DISTRO=$(lsb_release -is)
|
case $DISTRO in
|
||||||
|
ubuntu|debian)
|
||||||
|
handle_error sudo apt-get install -y unattended-upgrades apt-listchanges
|
||||||
|
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||||
|
|
||||||
case "$DISTRO" in
|
# Configure unattended-upgrades for security only
|
||||||
Ubuntu|Debian)
|
sudo tee /etc/apt/apt.conf.d/50unattended-upgrades > /dev/null <<EOF
|
||||||
echo "Setting up unattended upgrades for $DISTRO..."
|
Unattended-Upgrade::Allowed-Origins {
|
||||||
sudo apt-get update
|
"\${distro_id}:\${distro_codename}-security";
|
||||||
sudo apt-get install -y unattended-upgrades
|
"\${distro_id}ESMApps:\${distro_codename}-apps-security";
|
||||||
sudo dpkg-reconfigure --priority=low unattended-upgrades
|
"\${distro_id}ESM:\${distro_codename}-infra-security";
|
||||||
;;
|
};
|
||||||
Fedora)
|
|
||||||
echo "Setting up unattended upgrades for Fedora..."
|
|
||||||
sudo dnf install -y dnf-automatic
|
|
||||||
sudo systemctl enable --now dnf-automatic-install.timer
|
|
||||||
;;
|
|
||||||
"Arch Linux")
|
|
||||||
echo "Setting up unattended upgrades for Arch Linux..."
|
|
||||||
sudo pacman -Syu --noconfirm
|
|
||||||
sudo systemctl enable --now paccache.timer
|
|
||||||
;;
|
|
||||||
openSUSE)
|
|
||||||
echo "Setting up unattended upgrades for openSUSE..."
|
|
||||||
sudo zypper install -y yast2-online-update-configuration
|
|
||||||
sudo yast2 online_update_configuration
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
echo "Unsupported distribution: $DISTRO"
|
|
||||||
exit 1
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
echo "Unattended upgrades setup complete."
|
Unattended-Upgrade::Package-Blacklist {
|
||||||
|
};
|
||||||
|
|
||||||
|
Unattended-Upgrade::AutoFixInterruptedDpkg "true";
|
||||||
|
Unattended-Upgrade::MinimalSteps "true";
|
||||||
|
Unattended-Upgrade::Remove-Unused-Dependencies "true";
|
||||||
|
Unattended-Upgrade::Automatic-Reboot "false";
|
||||||
|
Unattended-Upgrade::Automatic-Reboot-Time "02:00";
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# Enable unattended-upgrades
|
||||||
|
sudo tee /etc/apt/apt.conf.d/20auto-upgrades > /dev/null <<EOF
|
||||||
|
APT::Periodic::Update-Package-Lists "1";
|
||||||
|
APT::Periodic::Unattended-Upgrade "1";
|
||||||
|
APT::Periodic::AutocleanInterval "7";
|
||||||
|
EOF
|
||||||
|
;;
|
||||||
|
fedora)
|
||||||
|
handle_error sudo dnf install -y dnf-automatic
|
||||||
|
sudo systemctl enable --now dnf-automatic-install.timer
|
||||||
|
|
||||||
|
# Configure for security updates only
|
||||||
|
sudo sed -i 's/upgrade_type = default/upgrade_type = security/' /etc/dnf/automatic.conf
|
||||||
|
sudo sed -i 's/apply_updates = no/apply_updates = yes/' /etc/dnf/automatic.conf
|
||||||
|
;;
|
||||||
|
arch)
|
||||||
|
log_info "Arch Linux: Automatic updates via pacman hooks recommended."
|
||||||
|
# Create a systemd timer for security updates
|
||||||
|
sudo tee /etc/systemd/system/pacman-security-update.service > /dev/null <<EOF
|
||||||
|
[Unit]
|
||||||
|
Description=Pacman Security Update
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=oneshot
|
||||||
|
ExecStart=/usr/bin/pacman -Syu --noconfirm
|
||||||
|
EOF
|
||||||
|
|
||||||
|
sudo tee /etc/systemd/system/pacman-security-update.timer > /dev/null <<EOF
|
||||||
|
[Unit]
|
||||||
|
Description=Run security updates daily
|
||||||
|
|
||||||
|
[Timer]
|
||||||
|
OnCalendar=daily
|
||||||
|
Persistent=true
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=timers.target
|
||||||
|
EOF
|
||||||
|
|
||||||
|
sudo systemctl enable pacman-security-update.timer
|
||||||
|
;;
|
||||||
|
opensuse)
|
||||||
|
handle_error sudo zypper install -y yast2-online-update-configuration
|
||||||
|
# Configure for automatic security updates
|
||||||
|
sudo sed -i 's/AUTOMATICALLY_UPDATE_PATCHES="no"/AUTOMATICALLY_UPDATE_PATCHES="yes"/' /etc/sysconfig/automatic_online_update
|
||||||
|
sudo systemctl enable --now automatic-online-update.timer
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
log_error "Unsupported distribution: $DISTRO"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
log_success "Automatic security updates configured."
|
||||||
|
}
|
||||||
|
|
||||||
|
# Logging functions if not available
|
||||||
|
if ! command -v log_info &>/dev/null; then
|
||||||
|
log_info() { echo "[INFO] $1"; }
|
||||||
|
log_success() { echo "[SUCCESS] $1"; }
|
||||||
|
log_error() { echo "[ERROR] $1" >&2; }
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Main execution
|
||||||
|
configure_unattended_upgrades
|
||||||
@@ -1,46 +1,24 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# Vaultwarden installation and configuration script
|
# Vaultwarden installation and configuration script (2025-enhanced)
|
||||||
|
|
||||||
install_vaultwarden() {
|
install_vaultwarden() {
|
||||||
log_info "Installing Vaultwarden..."
|
log_info "Installing Vaultwarden..."
|
||||||
|
|
||||||
if [ -f /etc/os-release ]; then
|
# Docker muss installiert sein
|
||||||
. /etc/os-release
|
if ! command -v docker &>/dev/null; then
|
||||||
OS=$ID
|
log_error "Docker ist nicht installiert. Bitte Docker zuerst installieren."
|
||||||
else
|
|
||||||
echo "Unsupported OS"
|
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
case $OS in
|
# Erstelle Verzeichnis für Vaultwarden
|
||||||
ubuntu|debian)
|
local vault_dir="${VAULTWARDEN_DATA_DIR:-/opt/vaultwarden}"
|
||||||
sudo apt update
|
sudo mkdir -p "$vault_dir"
|
||||||
sudo apt install -y docker.io docker-compose
|
sudo chown "$USER:$USER" "$vault_dir"
|
||||||
;;
|
|
||||||
fedora)
|
|
||||||
sudo dnf install -y docker docker-compose
|
|
||||||
;;
|
|
||||||
arch)
|
|
||||||
sudo pacman -Syu --noconfirm docker docker-compose
|
|
||||||
;;
|
|
||||||
opensuse)
|
|
||||||
sudo zypper install -y docker docker-compose
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
echo "Unsupported OS"
|
|
||||||
exit 1
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
sudo systemctl start docker
|
# Erstelle docker-compose.yml
|
||||||
sudo systemctl enable docker
|
cat <<EOF | sudo tee "$vault_dir/docker-compose.yml" > /dev/null
|
||||||
|
version: '3.8'
|
||||||
mkdir -p ~/vaultwarden
|
|
||||||
cd ~/vaultwarden
|
|
||||||
|
|
||||||
cat <<EOF > docker-compose.yml
|
|
||||||
version: '3'
|
|
||||||
services:
|
services:
|
||||||
vaultwarden:
|
vaultwarden:
|
||||||
image: vaultwarden/server:latest
|
image: vaultwarden/server:latest
|
||||||
@@ -49,16 +27,39 @@ services:
|
|||||||
volumes:
|
volumes:
|
||||||
- ./vw-data:/data
|
- ./vw-data:/data
|
||||||
ports:
|
ports:
|
||||||
- 80:80
|
- "8080:80" # HTTP on 8080
|
||||||
|
environment:
|
||||||
|
- WEBSOCKET_ENABLED=true
|
||||||
|
- SIGNUPS_ALLOWED=false # Disable signups by default for security
|
||||||
|
- ADMIN_TOKEN= # Set admin token later
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
# Pull the Vaultwarden image
|
cd "$vault_dir"
|
||||||
|
|
||||||
|
# Pull the latest image
|
||||||
handle_error sudo docker pull vaultwarden/server:latest
|
handle_error sudo docker pull vaultwarden/server:latest
|
||||||
|
|
||||||
# Create the Vaultwarden container
|
# Start Vaultwarden
|
||||||
handle_error sudo docker run -d --name vaultwarden -v /vw-data/:/data/ -p 80:80 --restart always vaultwarden/server:latest
|
handle_error sudo docker-compose up -d
|
||||||
|
|
||||||
log_info "Vaultwarden installation completed."
|
# Warte kurz und prüfe Status
|
||||||
|
sleep 5
|
||||||
|
if sudo docker ps | grep -q vaultwarden; then
|
||||||
|
log_success "Vaultwarden wurde erfolgreich installiert und läuft auf Port 8080."
|
||||||
|
log_info "Um Admin-Zugang zu aktivieren, setze ADMIN_TOKEN in der docker-compose.yml und starte neu."
|
||||||
|
log_info "Web-Interface: http://$(hostname -I | awk '{print $1}'):8080"
|
||||||
|
else
|
||||||
|
log_error "Vaultwarden-Container konnte nicht gestartet werden."
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
}
|
}
|
||||||
|
|
||||||
|
# Logging functions if not available
|
||||||
|
if ! command -v log_info &>/dev/null; then
|
||||||
|
log_info() { echo "[INFO] $1"; }
|
||||||
|
log_success() { echo "[SUCCESS] $1"; }
|
||||||
|
log_error() { echo "[ERROR] $1" >&2; }
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Main execution
|
||||||
install_vaultwarden
|
install_vaultwarden
|
||||||
163
setup.sh
163
setup.sh
@@ -4,11 +4,11 @@
|
|||||||
#
|
#
|
||||||
# This script automates the setup of a NAS system with various services.
|
# This script automates the setup of a NAS system with various services.
|
||||||
# It is designed to run on multiple Linux distributions, including:
|
# It is designed to run on multiple Linux distributions, including:
|
||||||
# - Ubuntu 20.04+
|
# - Ubuntu 24.04+
|
||||||
# - Debian 11+
|
# - Debian 12+
|
||||||
# - Fedora 35+
|
# - Fedora 41+
|
||||||
# - Arch Linux
|
# - Arch Linux
|
||||||
# - openSUSE Leap 15.4+
|
# - openSUSE Leap 15.6+
|
||||||
#
|
#
|
||||||
# Disclaimer:
|
# Disclaimer:
|
||||||
# This script is provided "as is", without warranty of any kind, express or implied,
|
# This script is provided "as is", without warranty of any kind, express or implied,
|
||||||
@@ -34,6 +34,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|||||||
source "${SCRIPT_DIR}/config/defaults.sh"
|
source "${SCRIPT_DIR}/config/defaults.sh"
|
||||||
source "${SCRIPT_DIR}/lib/logging.sh"
|
source "${SCRIPT_DIR}/lib/logging.sh"
|
||||||
source "${SCRIPT_DIR}/lib/common.sh"
|
source "${SCRIPT_DIR}/lib/common.sh"
|
||||||
|
source "${SCRIPT_DIR}/lib/detection.sh"
|
||||||
source "${SCRIPT_DIR}/lib/network.sh"
|
source "${SCRIPT_DIR}/lib/network.sh"
|
||||||
source "${SCRIPT_DIR}/lib/docker.sh"
|
source "${SCRIPT_DIR}/lib/docker.sh"
|
||||||
source "${SCRIPT_DIR}/lib/security.sh"
|
source "${SCRIPT_DIR}/lib/security.sh"
|
||||||
@@ -82,40 +83,140 @@ cleanup_on_exit() {
|
|||||||
|
|
||||||
trap cleanup_on_exit SIGINT SIGTERM
|
trap cleanup_on_exit SIGINT SIGTERM
|
||||||
|
|
||||||
# Detect Linux distribution with version check
|
# Detect Linux distribution with comprehensive fallback methods
|
||||||
detect_distro() {
|
detect_distro() {
|
||||||
|
local detected_distro=""
|
||||||
|
local detected_version=""
|
||||||
|
local detected_codename=""
|
||||||
|
local detection_method=""
|
||||||
|
|
||||||
|
log_debug "Starting distribution detection..."
|
||||||
|
|
||||||
|
# Method 1: /etc/os-release (primary method for modern systems)
|
||||||
if [[ -f /etc/os-release ]]; then
|
if [[ -f /etc/os-release ]]; then
|
||||||
source /etc/os-release
|
source /etc/os-release 2>/dev/null || true
|
||||||
DISTRO=$ID
|
detected_distro=${ID,,} # Convert to lowercase
|
||||||
DISTRO_VERSION=$VERSION_ID
|
detected_version=$VERSION_ID
|
||||||
DISTRO_CODENAME=${VERSION_CODENAME:-""}
|
detected_codename=${VERSION_CODENAME:-${UBUNTU_CODENAME:-""}}
|
||||||
|
detection_method="/etc/os-release"
|
||||||
|
log_debug "Detected via /etc/os-release: $PRETTY_NAME"
|
||||||
|
fi
|
||||||
|
|
||||||
log_info "Detected distribution: $PRETTY_NAME"
|
# Method 2: /etc/redhat-release (fallback for RHEL/CentOS/Fedora)
|
||||||
|
if [[ -z "$detected_distro" ]] && [[ -f /etc/redhat-release ]]; then
|
||||||
# Validate supported distribution
|
local redhat_info=$(cat /etc/redhat-release)
|
||||||
if [[ ! " ${SUPPORTED_DISTROS[*]} " =~ " ${DISTRO} " ]]; then
|
if [[ $redhat_info =~ ^(CentOS|Red Hat Enterprise|Fedora) ]]; then
|
||||||
log_error "Unsupported Linux distribution: $DISTRO"
|
detected_distro="fedora"
|
||||||
log_info "Supported distributions: ${SUPPORTED_DISTROS[*]}"
|
detected_version=$(echo "$redhat_info" | grep -oP '\d+\.\d+' | head -1)
|
||||||
exit 1
|
detection_method="/etc/redhat-release"
|
||||||
|
log_debug "Detected via /etc/redhat-release: $redhat_info"
|
||||||
fi
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
# Check minimum versions
|
# Method 3: /etc/debian_version (fallback for Debian/Ubuntu)
|
||||||
case $DISTRO in
|
if [[ -z "$detected_distro" ]] && [[ -f /etc/debian_version ]]; then
|
||||||
ubuntu)
|
local debian_version=$(cat /etc/debian_version)
|
||||||
if [[ $(echo "$DISTRO_VERSION >= 20.04" | bc -l) -eq 0 ]]; then
|
if [[ -f /etc/lsb-release ]]; then
|
||||||
log_warning "Ubuntu version $DISTRO_VERSION is not officially supported. Minimum: 20.04"
|
source /etc/lsb-release 2>/dev/null || true
|
||||||
fi
|
detected_distro=${DISTRIB_ID,,}
|
||||||
;;
|
detected_version=$DISTRIB_RELEASE
|
||||||
debian)
|
detected_codename=${DISTRIB_CODENAME:-""}
|
||||||
if [[ ${DISTRO_VERSION%%.*} -lt 11 ]]; then
|
detection_method="/etc/lsb-release"
|
||||||
log_warning "Debian version $DISTRO_VERSION is not officially supported. Minimum: 11"
|
else
|
||||||
fi
|
# Pure Debian system
|
||||||
;;
|
detected_distro="debian"
|
||||||
esac
|
detected_version=$debian_version
|
||||||
else
|
detection_method="/etc/debian_version"
|
||||||
log_error "Cannot detect Linux distribution. /etc/os-release not found."
|
fi
|
||||||
|
log_debug "Detected via Debian method: $detected_distro $detected_version"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Method 4: lsb_release command (fallback)
|
||||||
|
if [[ -z "$detected_distro" ]] && command -v lsb_release >/dev/null 2>&1; then
|
||||||
|
detected_distro=$(lsb_release -si 2>/dev/null | tr '[:upper:]' '[:lower:]')
|
||||||
|
detected_version=$(lsb_release -sr 2>/dev/null)
|
||||||
|
detected_codename=$(lsb_release -sc 2>/dev/null)
|
||||||
|
detection_method="lsb_release command"
|
||||||
|
log_debug "Detected via lsb_release command: $detected_distro $detected_version"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Method 5: uname and manual detection (last resort)
|
||||||
|
if [[ -z "$detected_distro" ]]; then
|
||||||
|
if [[ -f /etc/arch-release ]]; then
|
||||||
|
detected_distro="arch"
|
||||||
|
detected_version="rolling"
|
||||||
|
detection_method="/etc/arch-release"
|
||||||
|
elif [[ -f /etc/gentoo-release ]]; then
|
||||||
|
detected_distro="gentoo"
|
||||||
|
detected_version=$(cat /etc/gentoo-release | grep -oP '\d+\.\d+' | head -1)
|
||||||
|
detection_method="/etc/gentoo-release"
|
||||||
|
elif uname -a | grep -qi "opensuse"; then
|
||||||
|
detected_distro="opensuse"
|
||||||
|
detected_version="unknown"
|
||||||
|
detection_method="uname opensuse"
|
||||||
|
fi
|
||||||
|
log_debug "Detected via fallback method: $detected_distro"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Validate detection
|
||||||
|
if [[ -z "$detected_distro" ]]; then
|
||||||
|
log_error "Failed to detect Linux distribution using all available methods"
|
||||||
|
log_error "Please check your system and ensure it's a supported Linux distribution"
|
||||||
|
log_error "Supported: ${SUPPORTED_DISTROS[*]}"
|
||||||
exit 1
|
exit 1
|
||||||
fi
|
fi
|
||||||
|
|
||||||
|
# Normalize distribution names
|
||||||
|
case $detected_distro in
|
||||||
|
ubuntu|debian|fedora|arch|opensuse)
|
||||||
|
DISTRO=$detected_distro
|
||||||
|
;;
|
||||||
|
"red hat enterprise linux server"|"rhel")
|
||||||
|
DISTRO="fedora" # Treat RHEL as Fedora for package management
|
||||||
|
;;
|
||||||
|
"centos linux"|"centos")
|
||||||
|
DISTRO="fedora" # CentOS uses same package manager as Fedora
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
# Check if it's a known variant
|
||||||
|
if [[ " ${SUPPORTED_DISTROS[*]} " =~ " ${detected_distro} " ]]; then
|
||||||
|
DISTRO=$detected_distro
|
||||||
|
else
|
||||||
|
log_error "Detected distribution '$detected_distro' is not in supported list"
|
||||||
|
log_error "Supported distributions: ${SUPPORTED_DISTROS[*]}"
|
||||||
|
log_error "Detection method: $detection_method"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
# Parse and normalize version
|
||||||
|
DISTRO_VERSION=$(normalize_version "$detected_version")
|
||||||
|
DISTRO_CODENAME=$detected_codename
|
||||||
|
|
||||||
|
log_info "Distribution detected: $DISTRO $DISTRO_VERSION ($detection_method)"
|
||||||
|
if [[ -n "$DISTRO_CODENAME" ]]; then
|
||||||
|
log_debug "Codename: $DISTRO_CODENAME"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Validate supported distribution
|
||||||
|
if [[ ! " ${SUPPORTED_DISTROS[*]} " =~ " ${DISTRO} " ]]; then
|
||||||
|
log_error "Unsupported Linux distribution: $DISTRO"
|
||||||
|
log_info "Supported distributions: ${SUPPORTED_DISTROS[*]}"
|
||||||
|
log_info "Detection method: $detection_method"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check minimum versions with improved parsing
|
||||||
|
validate_minimum_version "$DISTRO" "$DISTRO_VERSION"
|
||||||
|
|
||||||
|
# Check for container environments
|
||||||
|
detect_container_environment
|
||||||
|
|
||||||
|
# Cache the results for performance
|
||||||
|
export DISTRO DETECTED_DISTRO=$DISTRO
|
||||||
|
export DISTRO_VERSION DETECTED_VERSION=$DISTRO_VERSION
|
||||||
|
export DISTRO_CODENAME DETECTED_CODENAME=$DISTRO_CODENAME
|
||||||
}
|
}
|
||||||
|
|
||||||
# System requirements check
|
# System requirements check
|
||||||
|
|||||||
@@ -7,6 +7,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|||||||
source "${SCRIPT_DIR}/../config/defaults.sh"
|
source "${SCRIPT_DIR}/../config/defaults.sh"
|
||||||
source "${SCRIPT_DIR}/../lib/logging.sh"
|
source "${SCRIPT_DIR}/../lib/logging.sh"
|
||||||
source "${SCRIPT_DIR}/../lib/common.sh"
|
source "${SCRIPT_DIR}/../lib/common.sh"
|
||||||
|
source "${SCRIPT_DIR}/../lib/detection.sh"
|
||||||
|
|
||||||
# Test configuration
|
# Test configuration
|
||||||
TEST_LOG_FILE="/tmp/nas_test.log"
|
TEST_LOG_FILE="/tmp/nas_test.log"
|
||||||
@@ -348,6 +349,92 @@ test_performance() {
|
|||||||
fi
|
fi
|
||||||
}
|
}
|
||||||
|
|
||||||
|
# Distribution detection tests
|
||||||
|
test_normalize_version() {
|
||||||
|
setup_test "normalize_version"
|
||||||
|
|
||||||
|
# Test standard version formats
|
||||||
|
local result=$(normalize_version "24.04.0")
|
||||||
|
assert_equals "24.04.0" "$result" "Standard version format"
|
||||||
|
|
||||||
|
result=$(normalize_version "12")
|
||||||
|
assert_equals "12.0.0" "$result" "Major version only"
|
||||||
|
|
||||||
|
result=$(normalize_version "41.1")
|
||||||
|
assert_equals "41.1.0" "$result" "Major.minor format"
|
||||||
|
|
||||||
|
# Test Debian-style versions
|
||||||
|
result=$(normalize_version "12 (bookworm)")
|
||||||
|
assert_equals "12.0.0" "$result" "Debian style version"
|
||||||
|
|
||||||
|
# Test rolling releases
|
||||||
|
result=$(normalize_version "rolling")
|
||||||
|
assert_equals "9999.0.0" "$result" "Rolling release"
|
||||||
|
|
||||||
|
result=$(normalize_version "unstable")
|
||||||
|
assert_equals "9999.0.0" "$result" "Unstable release"
|
||||||
|
|
||||||
|
# Test complex versions
|
||||||
|
result=$(normalize_version "24.04 LTS")
|
||||||
|
assert_equals "24.04.0" "$result" "Version with suffix"
|
||||||
|
}
|
||||||
|
|
||||||
|
test_version_compare() {
|
||||||
|
setup_test "version_compare"
|
||||||
|
|
||||||
|
# Test greater than or equal
|
||||||
|
version_compare "24.04.0" ">=" "24.04.0" && assert_true $? "Equal versions with >="
|
||||||
|
version_compare "24.04.1" ">=" "24.04.0" && assert_true $? "Higher version with >="
|
||||||
|
version_compare "24.03.0" ">=" "24.04.0" && assert_false $? "Lower version with >="
|
||||||
|
|
||||||
|
# Test greater than
|
||||||
|
version_compare "24.04.1" ">" "24.04.0" && assert_true $? "Higher version with >"
|
||||||
|
version_compare "24.04.0" ">" "24.04.0" && assert_false $? "Equal versions with >"
|
||||||
|
|
||||||
|
# Test less than or equal
|
||||||
|
version_compare "24.04.0" "<=" "24.04.0" && assert_true $? "Equal versions with <="
|
||||||
|
version_compare "24.03.0" "<=" "24.04.0" && assert_true $? "Lower version with <="
|
||||||
|
version_compare "24.05.0" "<=" "24.04.0" && assert_false $? "Higher version with <="
|
||||||
|
|
||||||
|
# Test less than
|
||||||
|
version_compare "24.03.0" "<" "24.04.0" && assert_true $? "Lower version with <"
|
||||||
|
version_compare "24.04.0" "<" "24.04.0" && assert_false $? "Equal versions with <"
|
||||||
|
|
||||||
|
# Test equal
|
||||||
|
version_compare "24.04.0" "==" "24.04.0" && assert_true $? "Equal versions with =="
|
||||||
|
version_compare "24.04.0" "=" "24.04.0" && assert_true $? "Equal versions with ="
|
||||||
|
version_compare "24.04.1" "==" "24.04.0" && assert_false $? "Different versions with =="
|
||||||
|
|
||||||
|
# Test not equal
|
||||||
|
version_compare "24.04.1" "!=" "24.04.0" && assert_true $? "Different versions with !="
|
||||||
|
version_compare "24.04.0" "!=" "24.04.0" && assert_false $? "Equal versions with !="
|
||||||
|
}
|
||||||
|
|
||||||
|
test_container_detection() {
|
||||||
|
setup_test "container_detection"
|
||||||
|
|
||||||
|
# Test that function exists and runs without error
|
||||||
|
# Note: On macOS, we won't detect actual containers, but the function should work
|
||||||
|
unset CONTAINER_TYPE
|
||||||
|
|
||||||
|
if detect_container_environment 2>/dev/null; then
|
||||||
|
echo " ✓ Container detection function runs without error"
|
||||||
|
((TESTS_PASSED++))
|
||||||
|
else
|
||||||
|
echo " ✗ Container detection function failed"
|
||||||
|
((TESTS_FAILED++))
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Test that CONTAINER_TYPE is set appropriately (should be empty on macOS)
|
||||||
|
if [[ -z "${CONTAINER_TYPE:-}" ]]; then
|
||||||
|
echo " ✓ No container environment detected (expected on macOS)"
|
||||||
|
((TESTS_PASSED++))
|
||||||
|
else
|
||||||
|
echo " ✓ Container environment detected: $CONTAINER_TYPE"
|
||||||
|
((TESTS_PASSED++))
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
# Main test runner
|
# Main test runner
|
||||||
main() {
|
main() {
|
||||||
echo "Starting NAS Setup Script Unit Tests"
|
echo "Starting NAS Setup Script Unit Tests"
|
||||||
@@ -382,6 +469,15 @@ main() {
|
|||||||
test_performance
|
test_performance
|
||||||
echo
|
echo
|
||||||
|
|
||||||
|
test_normalize_version
|
||||||
|
echo
|
||||||
|
|
||||||
|
test_version_compare
|
||||||
|
echo
|
||||||
|
|
||||||
|
test_container_detection
|
||||||
|
echo
|
||||||
|
|
||||||
# Cleanup
|
# Cleanup
|
||||||
rm -f "$TEST_LOG_FILE" "$TEST_CONFIG_FILE"
|
rm -f "$TEST_LOG_FILE" "$TEST_CONFIG_FILE"
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user