Ubuntu上 PhpStorm 文件共享设置
一、常用方案与选择
- SFTP（推荐）：通过 SSH 在 PhpStorm 中直接连接远程服务器，支持上传、下载、自动同步与对比，适合日常开发与部署。
- Samba/CIFS：在局域网内与 Windows/macOS 共享文件夹，Ubuntu 端作为服务器或客户端均可；在 PhpStorm 中可直接打开已挂载的共享目录进行编辑。
- NFS：Linux 环境常用的网络文件系统，适合多台 Linux 客户端共享；在 PhpStorm 中直接打开挂载目录即可使用。
二、方案一 SFTP 部署与自动同步（最常用）
- 在 Ubuntu 服务器启用 SSH
- 安装并启动服务：sudo apt update && sudo apt install openssh-server；sudo systemctl start ssh；sudo systemctl enable ssh。
- 在 PhpStorm 配置 SFTP
- 打开：Tools → Deployment → Configuration → + → SFTP，填写 Host（服务器 IP/域名）、Port 22、User、认证方式（Password 或 Key pair），点击 Test Connection 测试。
- 在 Root path 设置服务器工作目录；在 Mappings 中设置：
- Local path：本地项目路径
- Deployment path：相对于 Root path 的服务器路径
- Web path：Web 访问路径（如 /var/www/html）
- 常用操作：
- Upload to… / Download from…：手动上传/下载
- Automatic Upload：保存即自动同步
- Sync with Deployment to…：对比并选择保留变更
- 适用场景：远程开发、测试/预发布环境同步、团队协作服务器。
三、方案二 Samba/CIFS 共享（Ubuntu 与 Windows/macOS 互通）
- Ubuntu 作为 Samba 服务器
- 安装与创建共享：sudo apt install samba；mkdir -p /home/your_username/samba_share；chmod 777 samba_share（或更安全的权限）。
- 编辑 /etc/samba/smb.conf，在末尾添加：
- [samba_share]
- path = /home/your_username/samba_share
- available = yes；browseable = yes；valid users = your_username
- public = yes（或 no，配合鉴权）；writable = yes
- 创建 Samba 用户：sudo smbpasswd -a your_username；重启服务：sudo systemctl restart smbd。
- 防火墙放行（如使用 UFW）：sudo ufw allow samba。
- 在 PhpStorm 中使用
- 若 PhpStorm 运行在 Ubuntu：将共享目录挂载到本地（如 /mnt/smb），然后在 PhpStorm 直接 File → Open 打开该本地挂载路径进行编辑。
- 若 PhpStorm 运行在 Windows：在资源管理器访问 \服务器IP\samba_share，可映射为网络驱动器后在 PhpStorm 中打开。
- 适用场景：跨系统团队共享、局域网内快速协作。
四、方案三 NFS 共享（Linux 到 Linux）
- Ubuntu 作为 NFS 服务器
- 安装与创建共享：sudo apt-get install nfs-kernel-server；mkdir -p /srv/nfs/share；chown nobody:nogroup /srv/nfs/share；chmod 0775 /srv/nfs/share。
- 编辑 /etc/exports：/srv/nfs/share client_ip(rw,sync,no_subtree_check)；导出：sudo exportfs -a；重启服务：sudo systemctl restart nfs-kernel-server。
- 客户端挂载（含 PhpStorm 所在机器）
- 安装客户端：sudo apt install nfs-common；创建挂载点：sudo mkdir -p /mnt/nfs/share；
- 挂载：sudo mount server_ip:/srv/nfs/share /mnt/nfs/share；如需开机自动挂载，加入 /etc/fstab：server_ip:/srv/nfs/share /mnt/nfs/share nfs defaults,user,exec 0 0。
- 在 PhpStorm 中使用
- 直接 File → Open 打开 /mnt/nfs/share 下的项目进行编辑与调试。
- 适用场景：多台 Linux 开发机共享同一代码目录、容器/虚拟机与宿主机共享。
五、常见问题与排查
- 连接失败
- 确认网络与端口可达（SFTP 为 22，Samba 为 445，NFS 为 2049）；检查防火墙/安全组策略；核对用户名、密码或密钥是否正确。
- 权限问题
- Samba：确保共享目录属主与 valid users 一致，必要时设置更严格的权限（如 0755/0770）；NFS：导出目录属主为 nobody:nogroup 且权限允许客户端读写。
- 自动同步未生效
- 在 PhpStorm 的 Deployment → Options 勾选 Upload changed files automatically to the default server；确认当前项目已绑定正确的 Deployment 配置。
- Windows 访问 Samba 慢或失败
- 关闭或放行防火墙（如 UFW 的 Samba 规则），核对工作组/用户名密码，必要时在 smb.conf 中设置合适的 client min protocol / server min protocol。