Hyperledger Composer安装失败及GUI访问问题求助

1. Accessing Hyperledger Composer Playground GUI via Browser #

Since you're connecting to your Ubuntu server via Xshell, the most reliable way to access Playground is to run it on the server and use SSH port forwarding to reach it from your local browser. Here's how to set it up:

• First, install the Playground package globally on your server:

  sudo npm install -g composer-playground --unsafe-perm
  

• Start Playground (it runs on port 8080 by default):

  composer-playground
  

• Configure port forwarding in Xshell:
  1. Open your session properties (right-click the active session → Properties)
  2. Navigate to Connection > SSH > Tunnels
  3. Add a new forward rule:
     • Source port: 8080
     • Destination: localhost:8080
     • Select Local and Auto options
     • Click "Add" then "OK" to save
• On your local machine, open any browser and visit http://localhost:8080 – you’ll see the Playground interface load right up.

Alternative (slower) option: X11 Forwarding
If you want to run a browser directly on the server and forward the GUI to your local desktop:

• Enable X11 forwarding in Xshell (Session properties → Connection → SSH → X11 → Check "Enable X11 forwarding")
• Install a browser on Ubuntu: sudo apt-get install firefox
• Start Playground: composer-playground – it will open Firefox on your local machine via X11. Note this can be laggy over slow SSH connections, so port forwarding is preferred.

2. Fixing composer --version Not Working After Install #

This issue usually boils down to PATH configuration or permission problems. Let’s walk through troubleshooting steps:

Step 1: Confirm the install location #

Run this command to find where composer-cli was installed:

sudo npm list -g composer-cli

The executable should be linked to /usr/local/bin/composer (npm’s default global bin directory). Jot down the path if it’s somewhere else.

Step 2: Check if the bin directory is in your PATH #

• For your regular user: Run echo $PATH – if /usr/local/bin isn’t listed, add it to your shell config:

  echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.bashrc
  source ~/.bashrc
  

• For root: Run sudo echo $PATH – if /usr/local/bin is missing, add the same line to /root/.bashrc and source it.

Step 3: Verify file permissions #

Make sure the composer executable is accessible to your user:

ls -l /usr/local/bin/composer

It should have permissions like -rwxr-xr-x (755). If not, fix it with:

sudo chmod 755 /usr/local/bin/composer

Step 4: Install without sudo (recommended for user-specific setups) #

Using sudo can sometimes cause PATH conflicts. Configure npm to install global packages in your user directory instead:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g composer-cli --unsafe-perm

Now composer --version should work as your regular user without needing sudo.

内容的提问来源于stack exchange，提问作者David