Nuclei-Software / nuclei-linux-sdk

Nuclei RISC-V Linux Software Development Kit
Apache License 2.0
38 stars 9 forks source link

Using prebuilt linuxsdk docker image #8

Open fanghuaqi opened 1 year ago

fanghuaqi commented 1 year ago

We have prepared a linuxsdk docker image located in https://hub.docker.com/repository/docker/nucleisoftware/linuxsdk, you can use the docker image there, if you don't want to step the environment by yourself.

If you don't want to use docker, please following #4 to download code

The following branches are enabled with docker support: Available tags: https://hub.docker.com/repository/docker/nucleisoftware/linuxsdk/tags

  • dev_nuclei_next: nucleisoftware/linuxsdk:ci , later on it will be nucleisoftware/linuxsdk:dev_nuclei_next
  • dev_nuclei_5.10/dev_nuclei_5.10_v2/dev_nuclei_6.1/dev_nuclei_6.1_v2/dev_nuclei_6.6_v2: docker tag is the branch name, eg. for branch dev_nuclei_5.10, the docker image is nucleisoftware/linuxsdk:dev_nuclei_5.10

NOTE For evaluating optee, see https://github.com/Nuclei-Software/nuclei-linux-sdk/issues/13 , this docker image is uploaded by @fanghuaqi manually, not ci generated.

Recommended docker tags: dev_nuclei_5.10_v2, dev_nuclei_6.1_v2, dev_nuclei_6.6_v2

NOTE: not work for upload freeloader, you need to copy the freeloader to out side of docker, and program to flash using openocd and gdb by yourself, see https://github.com/Nuclei-Software/nuclei-linux-sdk/wiki/Program-freeloader

Sample steps:

  1. Make sure your docker is installed in your linux environment, see https://docs.docker.com/engine/install/ubuntu/
  2. Make sure you have good connection to docker hub, otherwise use mirror of docker hub, search it by yourself
  3. Use the docker image of linux sdk
# In Host
## if using docker hub mirror from docker.mirrors.sjtug.sjtu.edu.cn , you can run like this
# docker run -it docker.mirrors.sjtug.sjtu.edu.cn/nucleisoftware/linuxsdk:dev_nuclei_5.10_v2
# Here below just pull docker from official docker hub
docker run -it nucleisoftware/linuxsdk:dev_nuclei_5.10_v2
# In docker now, user/pwd: nuclei/riscv123
cd nuclei-linux-sdk
# build project just follow https://github.com/Nuclei-Software/nuclei-linux-sdk#show-help
# this linux sdk repo cloned in this docker image is not full clone
# if you want to update source code or checkout different branch, do it as you like

image

image

fanghuaqi commented 1 year ago

In this docker image, SOC=demosoc CORE=ux600 is default prebuilt with freeloader and bootimages, you can directly use it, Nuclei QEMU is also installed, but Nuclei OpenOCD is not installed.

2023.11.24 -> For latest image, it use the default config in Makefile.

fanghuaqi commented 7 months ago

Since 2023.11.23, branch dev_nuclei_5.10/dev_nuclei_5.10_v2/dev_nuclei_6.1/dev_nuclei_6.1_v2 are enabled with docker image support, docker tag is the branch name, eg. for branch dev_nuclei_5.10, the docker image is nucleisoftware/linuxsdk:dev_nuclei_5.10

fanghuaqi commented 7 months ago

Since 2023.11.27, the prebuilt docker image(ci generated) for branch dev_nuclei_5.10/dev_nuclei_5.10_v2/dev_nuclei_6.1/dev_nuclei_6.1_v2/dev_nuclei_next size decreased from near 8G to about 2G, this decrease is caused by the linux sdk source code in these images are shallow cloned(with --depth 10), if you want to pull the complete source code, you need to run git fetch --unshallow, but it will cost time and may fail depending on your network to github.

Note: now in these images, gitee remote is remoted due to gitee mirror is now not working, see https://github.com/Nuclei-Software/nuclei-linux-sdk/issues/10#issuecomment-1728920670

fanghuaqi commented 6 months ago

Since 2023.12.20, the prebuilt docker image(ci generated) for branch dev_nuclei_6.6_v2 using gcc13 is pushed to https://hub.docker.com/r/nucleisoftware/linuxsdk , tag dev_nuclei_6.6_v2

fanghuaqi commented 6 months ago

Docker hub mirror see https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6

gist.github.com 无法访问问题,请自行百度解决

screenhost of above link content @ 2023.12.22

image

sunao2002002 commented 1 month ago

What is the password for nuclei when using the docker image?

fanghuaqi commented 1 month ago

What is the password for nuclei when using the docker image?

# In docker now, user/pwd: nuclei/riscv123

sunao2002002 commented 1 month ago

What is the password for nuclei when using the docker image?

# In docker now, user/pwd: nuclei/riscv123

Thanks for the answer. It works.