Skip to content

Repository files navigation

NFS Free Edition

Network File System (NFS) — Free Edition

Free, open-source aaPanel plugin for complete NFS management

Share directories, mount remote filesystems, monitor your NFS server
and diagnose mount failures — all from a graphical panel interface.


License Version Python Platform aaPanel NFS


Stars Forks Issues


This free, open-source plugin for aaPanel simplifies the administration of the Network File System (NFS) through a graphical interface. It enables administrators to manage NFS exports, mount remote directories and configure automatic startup of shares at boot time. An intelligent diagnostic engine identifies connection failures and suggests targeted solutions for network problems. Users can monitor server performance in real time and review detailed activity logs to ensure operational security. Automated installation scripts and multilingual support make global deployment on Linux environments straightforward.

Features

📂 NFS Shares Create and manage exports with per-client IP/CIDR control, rw/ro modes and squash policies
🔗 Remote Mounts Mount remote NFS paths with full protocol options: NFSv3/v4, rsize/wsize, TCP/UDP, hard/soft
📊 Server Monitoring Live status of nfs-server and rpcbind, RPC service list, /proc/net/rpc stats, nfsiostat I/O metrics
🚀 Auto-mount at Boot SysV init service mounts all auto_mount=1 entries automatically on system startup
🔍 Intelligent Diagnostics 7-step failure analysis — ping, IP detection, port check, showmount, CIDR matching — with actionable suggestions
📋 Activity Log Thread-safe audit log of every operation, filterable by event type, result and IP address
🔄 Connection Tracking Detects mounts and client connections that happen outside the plugin in real time

Quick Install

# 1. Copy plugin files to the aaPanel plugin directory
cp -r nfs_free/ /www/server/panel/plugin/nfs_free/

# 2. Run the installer
sudo bash /www/server/panel/plugin/nfs_free/install.sh install

The installer handles NFS packages, fixed-port configuration for mountd (20048), firewall rules, SysV init service and systemd service activation automatically.


Screenshots

Dashboard

NFS Free Edition — Dashboard

Shared List

NFS Free Edition — Shared List

Mount List

NFS Free Edition — Mount List

Service Status

NFS Free Edition — Service Status

Activity Log

NFS Free Edition — Activity Log


Ports Required on the Server

Port Service Protocol Role
111 rpcbind TCP/UDP Port mapper
2049 nfs TCP NFS data transfer
20048 mountd TCP/UDP Mount requests (pinned)
32874 lockd TCP/UDP File locking
32876 statd TCP/UDP State recovery

Documentation

Language File
🇪🇸 Español README_ES.md
🇧🇷 Português README_PT.md
🇬🇧 English README_EN.md
🇯🇵 日本語 README_JA.md
🇩🇪 Deutsch README_DE.md
🇷🇺 Русский README_RU.md

Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/my-feature
  3. Commit your changes: git commit -m 'Add: my feature'
  4. Push and open a Pull Request

See README_EN.md for full contribution guidelines.


Made with care by Jose Alexis Correa Valencia · Colombia 🇨🇴

GitHub LinkedIn Email

Network File System (NFS) Free Edition — Copyright © 2023 Jose Alexis Correa Valencia — Published July 31, 2023 — MIT License

About

Free NFS plugin for aaPanel — manage NFS exports and mounts with full GUI, auto-mount at boot and intelligent failure diagnostics

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages