A native macOS application for seamless SMB network share management
Features • Installation • Quick Start • Configuration • Shortcuts • Troubleshooting
LanMount is a powerful yet simple macOS menu bar application that makes connecting to SMB (Server Message Block) network shares as easy as using a local drive. Built with native macOS technologies, it provides automatic network discovery, secure credential management, and seamless Finder integration.
Whether you're connecting to a NAS device, a Windows file server, or another Mac's shared folders, LanMount streamlines the entire process with features like auto-mount at login, real-time status monitoring, and optional file synchronization.
- Automatic SMB Discovery: Uses Bonjour/mDNS to automatically find SMB servers on your local network
- Real-time Updates: Discovered servers appear instantly as they're found
- One-Click Connection: Select a discovered server and connect with a single click
- Easy Mounting: Mount SMB shares with a simple, intuitive interface
- Quick Unmount: Safely unmount shares from the menu bar or Finder
- Multiple Shares: Connect to multiple SMB shares simultaneously (up to 10+)
- Custom Mount Points: Choose where shares appear in your filesystem
- Keychain Integration: Credentials are securely stored in macOS Keychain
- Per-Share Credentials: Different credentials for different servers
- Remember Me: Option to save credentials for quick reconnection
- Login Items: Automatically start LanMount when you log in
- Auto-Connect: Automatically mount your favorite shares at startup
- Smart Reconnection: Automatically reconnect when network becomes available
- Real-time Sync: Keep local copies synchronized with remote shares
- Bidirectional Sync: Changes sync both ways
- Conflict Resolution: Smart handling of simultaneous edits
- Selective Sync: Choose which folders to synchronize
- Menu Bar Status: See connection status at a glance
- Real-time Notifications: Get notified of connection changes
- Volume Monitoring: Automatic detection of disconnections
- Connection Health: Monitor the health of your connections
- Sidebar Display: Mounted shares appear in Finder's sidebar
- Native Experience: Works just like local drives
- Custom Icons: Easy identification of network shares
- Right-Click Eject: Unmount directly from Finder
一目了然的连接状态总览，显示所有已挂载磁盘和快速操作面板。
管理所有 SMB 连接配置，支持自动挂载和自定义设置。
实时监控存储使用情况，包括容量、使用率和 I/O 监控图表。
自定义应用设置，包括语言、启动选项、通知偏好和数据管理。
菜单栏图标实时显示挂载状态，点击可快速访问所有功能。
| Requirement | Specification |
|---|---|
| Operating System | macOS 12.0 (Monterey) or later |
| Processor | Apple Silicon (M1/M2/M3/M4) or Intel |
| Memory | 50 MB available RAM |
| Disk Space | 20 MB for installation |
| Network | Local network access for SMB connections |
- Download the latest
LanMount.dmgfrom the Releases page - Open the downloaded DMG file
- Drag LanMount to your Applications folder
- Eject the DMG
- Launch LanMount from Applications or Spotlight
brew install --cask lanmountOn first launch, macOS may show a security warning because the app is downloaded from the internet:
- Go to System Settings → Privacy & Security
- Scroll down to find the message about LanMount
- Click Open Anyway
- Enter your password if prompted
Note: LanMount is notarized by Apple, ensuring it's free from known malware.
After installation, launch LanMount. You'll see a new icon in your menu bar:
- Click the LanMount menu bar icon
- Select Scan Network...
- Wait for the scan to complete (up to 30 seconds)
- Available SMB servers will appear in the list
From Network Scan:
- Click on a discovered server
- Select the share you want to mount
- Enter credentials if required
- Click Mount
Manual Connection:
- Click the menu bar icon
- Select Add New Mount...
- Enter the server address (e.g.,
192.168.1.100orserver.local) - Enter the share name
- Provide credentials
- Click Mount
Once mounted, your share will appear:
- In Finder's sidebar under Locations
- In
/Volumes/ShareName - In the LanMount menu with a green status indicator
When adding a new mount, you can configure:
| Option | Description |
|---|---|
| Server Address | IP address or hostname of the SMB server |
| Share Name | Name of the shared folder |
| Username | Your username for authentication |
| Password | Your password (stored securely in Keychain) |
| Mount Point | Where to mount (default: /Volumes/ShareName) |
| Auto-Mount | Automatically mount at login |
| Remember Credentials | Save credentials to Keychain |
| Enable Sync | Enable file synchronization |
Access preferences from the menu bar: LanMount → Preferences...
- Launch at Login: Start LanMount automatically when you log in
- Auto-Reconnect: Automatically reconnect when a share becomes available
- Show Notifications: Display system notifications for events
- Sync Interval: How often to check for changes
- Exclude Files: Patterns for files to ignore during sync
- Log Level: Set logging verbosity (Debug, Info, Warning, Error)
- View Logs: Open the log file location
LanMount stores its configuration in:
~/Library/Application Support/SMBMounter/config.json
| Shortcut | Action |
|---|---|
⌘ + N |
Add new mount |
⌘ + R |
Refresh/Scan network |
⌘ + , |
Open Preferences |
⌘ + Q |
Quit LanMount |
The menu bar icon indicates the current status:
| Icon | Status |
|---|---|
externaldrive.connected.to.line.below |
All shares connected |
externaldrive.badge.timemachine |
Connecting to a share |
externaldrive.badge.xmark |
One or more shares disconnected |
LanMount supports standard SMB URL formats:
smb://server/share
smb://username@server/share
smb://username:password@server/share
smb://DOMAIN;username@server/share
Logs are stored in:
~/Library/Logs/SMBMounter/
Log files are automatically rotated:
- Maximum file size: 10 MB
- Maximum files kept: 5
- Older logs are compressed
- Credentials: Stored in macOS Keychain with highest security level
- Configuration: Stored locally with user-only permissions (0600)
- Logs: No passwords or sensitive data are logged
- Network Access: To connect to SMB servers
- File System Access: To mount shares and sync files
- Keychain Access: To securely store credentials
- Notifications: To alert you of connection changes (optional)
LanMount follows macOS security best practices and requests only the minimum permissions necessary for operation.
For common issues and solutions, see the Troubleshooting Guide.
Quick fixes for common problems:
- Can't find server: Ensure you're on the same network
- Authentication failed: Double-check username and password
- Mount fails: Check if the share name is correct
- Disconnections: Enable auto-reconnect in preferences
We welcome contributions! Feel free to open issues or submit pull requests on GitHub.
LanMount is released under the MIT License.
- Built with Swift and SwiftUI
- Uses macOS native frameworks: NetFS, Network, Security, ServiceManagement
- Icon design inspired by macOS design guidelines
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: wangxso@hotmail.com
Made with ❤️ for the macOS community
LanMount 支持两种发布方式：
推送 tag 即可自动构建、签名、公证并发布：
git tag v1.0.0
git push origin v1.0.0GitHub Actions 会自动：
- ✅ 构建应用
- ✅ 代码签名
- ✅ 创建 DMG
- ✅ Apple 公证
- ✅ 创建 GitHub Release
- ✅ 上传 DMG
使用 Fastlane 在本地构建和发布：
cd LanMount
# 测试构建（不公证）
fastlane test_build version:1.0.0
# 完整发布（包括公证）
fastlane release version:1.0.0详见 Fastlane 指南
- 快速开始 - 快速构建和发布指南
- Fastlane 指南 - 使用 Fastlane 自动化发布
- GitHub Actions 配置 - 配置自动发布
- 代码签名指南 - 代码签名和公证
- 发布指南 - 详细发布流程
- 故障排除 - 常见问题解决